ホーム › NetworkManagement.P2P › PEER_GRAPH_PROPERTIES
PEER_GRAPH_PROPERTIES
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dwSize | DWORD | 4 | +0 | +0 | このデータ構造のサイズをバイト単位で指定します。dwSize メンバーは、PeerGraphCreate を呼び出す前に PEER_GRAPH_PROPERTIES のサイズに設定しなければなりません。このメンバーは必須です。既定値はありません。 | ||||||||
| dwFlags | DWORD | 4 | +4 | +4 | グラフ内のピアの動作を制御するフラグです。既定ではフラグは設定されていません。有効な値は次の表のとおりです。
| ||||||||
| dwScope | DWORD | 4 | +8 | +8 | ピアグラフ ID が公開されるスコープを指定します。既定値はグローバルです。有効な値は次の表のとおりです。
| ||||||||
| dwMaxRecordSize | DWORD | 4 | +12 | +12 | ピアグラフに追加できるレコードの最大サイズを示す値を指定します。有効な値は 0 (既定の最大レコードサイズである 60 メガバイトが使用されることを示します)、および 1024 バイトから 60 メガバイトまでの任意の値です。 | ||||||||
| pwzGraphId | LPWSTR | 8/4 | +16 | +16 | ピアグラフの一意の識別子を指定します。この ID は、コンピューターとユーザーの組み合わせにおいて一意でなければなりません。このメンバーは必須で、既定値はありません。文字列の値が 256 文字 (null 終端文字を含む) を超える場合は、エラーが返されます。 | ||||||||
| pwzCreatorId | LPWSTR | 8/4 | +24 | +20 | ピアグラフの作成者の一意の識別子を指定します。このメンバーは必須で、既定値はありません。文字列の値が 256 文字 (null 終端文字を含む) を超える場合は、エラーが返されます。 | ||||||||
| pwzFriendlyName | LPWSTR | 8/4 | +32 | +24 | ピアグラフのフレンドリ名を指定します。このメンバーは省略可能で、NULL を指定できます。既定値は NULL です。この文字列の最大長は、null 終端文字を含めて 256 文字です。 | ||||||||
| pwzComment | LPWSTR | 8/4 | +40 | +28 | ピアグラフを説明するために使用するコメントを指定します。このメンバーは省略可能で、NULL を指定できます。既定値は NULL です。この文字列の最大長は、null 終端文字を含めて 512 文字です。 | ||||||||
| ulPresenceLifetime | DWORD | 4 | +48 | +32 | プレゼンスレコードが期限切れになるまでの秒数を指定します。既定値は 300 秒 (5 分) です。ulPresenceLifetime の値は 300 秒未満に設定しないでください。このメンバーを既定値の 300 秒 (5 分) より小さい値に設定すると、未定義の動作が発生する可能性があります。 | ||||||||
| cPresenceMax | DWORD | 4 | +52 | +36 | Peer Infrastructure がピアグラフ内に同時に保持するプレゼンスレコードの数を指定します。プレゼンスが公開されているノードは、PeerGraphEnumNodes によって他のすべてのノードから列挙できます。ユーザーのプレゼンスレコードを公開する方法は、次の表に示す値のいずれかを指定して決定します。
|
公式ドキュメント
PEER_GRAPH_PROPERTIES 構造体は、ピアグラフのポリシー、ID、スコープなどの情報を格納します。
解説(Remarks)
アプリケーションは、PeerGraphSetPresence を使用して、Peer Graphing Infrastructure にプレゼンス情報を強制的に公開させることができます。
PeerGraphSetProperties を呼び出すときに更新できるのは、PEER_GRAPH_PROPERTIES の特定のフィールドのみです。更新できるメンバーは次のとおりです。
- pwzFriendlyName
- pwzComment
- ulPresenceLifetime
- cPresenceMax
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// PEER_GRAPH_PROPERTIES (x64 56 / x86 40 バイト)
typedef struct PEER_GRAPH_PROPERTIES {
DWORD dwSize;
DWORD dwFlags;
DWORD dwScope;
DWORD dwMaxRecordSize;
LPWSTR pwzGraphId;
LPWSTR pwzCreatorId;
LPWSTR pwzFriendlyName;
LPWSTR pwzComment;
DWORD ulPresenceLifetime;
DWORD cPresenceMax;
} PEER_GRAPH_PROPERTIES;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PEER_GRAPH_PROPERTIES
{
public uint dwSize;
public uint dwFlags;
public uint dwScope;
public uint dwMaxRecordSize;
public IntPtr pwzGraphId;
public IntPtr pwzCreatorId;
public IntPtr pwzFriendlyName;
public IntPtr pwzComment;
public uint ulPresenceLifetime;
public uint cPresenceMax;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PEER_GRAPH_PROPERTIES
Public dwSize As UInteger
Public dwFlags As UInteger
Public dwScope As UInteger
Public dwMaxRecordSize As UInteger
Public pwzGraphId As IntPtr
Public pwzCreatorId As IntPtr
Public pwzFriendlyName As IntPtr
Public pwzComment As IntPtr
Public ulPresenceLifetime As UInteger
Public cPresenceMax As UInteger
End Structureimport ctypes
from ctypes import wintypes
class PEER_GRAPH_PROPERTIES(ctypes.Structure):
_fields_ = [
("dwSize", wintypes.DWORD),
("dwFlags", wintypes.DWORD),
("dwScope", wintypes.DWORD),
("dwMaxRecordSize", wintypes.DWORD),
("pwzGraphId", ctypes.c_void_p),
("pwzCreatorId", ctypes.c_void_p),
("pwzFriendlyName", ctypes.c_void_p),
("pwzComment", ctypes.c_void_p),
("ulPresenceLifetime", wintypes.DWORD),
("cPresenceMax", wintypes.DWORD),
]#[repr(C)]
pub struct PEER_GRAPH_PROPERTIES {
pub dwSize: u32,
pub dwFlags: u32,
pub dwScope: u32,
pub dwMaxRecordSize: u32,
pub pwzGraphId: *mut core::ffi::c_void,
pub pwzCreatorId: *mut core::ffi::c_void,
pub pwzFriendlyName: *mut core::ffi::c_void,
pub pwzComment: *mut core::ffi::c_void,
pub ulPresenceLifetime: u32,
pub cPresenceMax: u32,
}import "golang.org/x/sys/windows"
type PEER_GRAPH_PROPERTIES struct {
dwSize uint32
dwFlags uint32
dwScope uint32
dwMaxRecordSize uint32
pwzGraphId uintptr
pwzCreatorId uintptr
pwzFriendlyName uintptr
pwzComment uintptr
ulPresenceLifetime uint32
cPresenceMax uint32
}type
PEER_GRAPH_PROPERTIES = record
dwSize: DWORD;
dwFlags: DWORD;
dwScope: DWORD;
dwMaxRecordSize: DWORD;
pwzGraphId: Pointer;
pwzCreatorId: Pointer;
pwzFriendlyName: Pointer;
pwzComment: Pointer;
ulPresenceLifetime: DWORD;
cPresenceMax: DWORD;
end;const PEER_GRAPH_PROPERTIES = extern struct {
dwSize: u32,
dwFlags: u32,
dwScope: u32,
dwMaxRecordSize: u32,
pwzGraphId: ?*anyopaque,
pwzCreatorId: ?*anyopaque,
pwzFriendlyName: ?*anyopaque,
pwzComment: ?*anyopaque,
ulPresenceLifetime: u32,
cPresenceMax: u32,
};type
PEER_GRAPH_PROPERTIES {.bycopy.} = object
dwSize: uint32
dwFlags: uint32
dwScope: uint32
dwMaxRecordSize: uint32
pwzGraphId: pointer
pwzCreatorId: pointer
pwzFriendlyName: pointer
pwzComment: pointer
ulPresenceLifetime: uint32
cPresenceMax: uint32struct PEER_GRAPH_PROPERTIES
{
uint dwSize;
uint dwFlags;
uint dwScope;
uint dwMaxRecordSize;
void* pwzGraphId;
void* pwzCreatorId;
void* pwzFriendlyName;
void* pwzComment;
uint ulPresenceLifetime;
uint cPresenceMax;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PEER_GRAPH_PROPERTIES サイズ: 40 バイト(x86)
dim st, 10 ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; dwScope : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwMaxRecordSize : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; pwzGraphId : LPWSTR (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; pwzCreatorId : LPWSTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; pwzFriendlyName : LPWSTR (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; pwzComment : LPWSTR (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; ulPresenceLifetime : DWORD (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; cPresenceMax : DWORD (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PEER_GRAPH_PROPERTIES サイズ: 56 バイト(x64)
dim st, 14 ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; dwScope : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwMaxRecordSize : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; pwzGraphId : LPWSTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; pwzCreatorId : LPWSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; pwzFriendlyName : LPWSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; pwzComment : LPWSTR (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ulPresenceLifetime : DWORD (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; cPresenceMax : DWORD (+52, 4byte) st.13 = 値 / 値 = st.13 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PEER_GRAPH_PROPERTIES
#field int dwSize
#field int dwFlags
#field int dwScope
#field int dwMaxRecordSize
#field intptr pwzGraphId
#field intptr pwzCreatorId
#field intptr pwzFriendlyName
#field intptr pwzComment
#field int ulPresenceLifetime
#field int cPresenceMax
#endstruct
stdim st, PEER_GRAPH_PROPERTIES ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize