Win32 API 日本語リファレンス
ホームNetworkManagement.P2P › PEER_GRAPH_PROPERTIES

PEER_GRAPH_PROPERTIES

構造体
サイズx64: 56 バイト / x86: 40 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0このデータ構造のサイズをバイト単位で指定します。dwSize メンバーは、PeerGraphCreate を呼び出す前に PEER_GRAPH_PROPERTIES のサイズに設定しなければなりません。このメンバーは必須です。既定値はありません。
dwFlagsDWORD4+4+4

グラフ内のピアの動作を制御するフラグです。既定ではフラグは設定されていません。有効な値は次の表のとおりです。

Value Description
PEER_GRAPH_PROPERTY_DEFER_EXPIRATION グラフレコードを期限切れにするタイミングを指定します。グラフが接続されておらず、このフラグが設定されている場合、グラフが他の少なくとも 1 つのメンバーに接続するまで期限切れは発生しません。
dwScopeDWORD4+8+8

ピアグラフ ID が公開されるスコープを指定します。既定値はグローバルです。有効な値は次の表のとおりです。

Value Description
PEER_GRAPH_SCOPE_GLOBAL スコープにインターネットが含まれます。
PEER_GRAPH_SCOPE_LINK_LOCAL スコープはローカルサブネットに制限されます。
PEER_GRAPH_SCOPE_SITE_LOCAL スコープはサイト (企業のイントラネットなど) に制限されます。
dwMaxRecordSizeDWORD4+12+12ピアグラフに追加できるレコードの最大サイズを示す値を指定します。有効な値は 0 (既定の最大レコードサイズである 60 メガバイトが使用されることを示します)、および 1024 バイトから 60 メガバイトまでの任意の値です。
pwzGraphIdLPWSTR8/4+16+16ピアグラフの一意の識別子を指定します。この ID は、コンピューターとユーザーの組み合わせにおいて一意でなければなりません。このメンバーは必須で、既定値はありません。文字列の値が 256 文字 (null 終端文字を含む) を超える場合は、エラーが返されます。
pwzCreatorIdLPWSTR8/4+24+20ピアグラフの作成者の一意の識別子を指定します。このメンバーは必須で、既定値はありません。文字列の値が 256 文字 (null 終端文字を含む) を超える場合は、エラーが返されます。
pwzFriendlyNameLPWSTR8/4+32+24ピアグラフのフレンドリ名を指定します。このメンバーは省略可能で、NULL を指定できます。既定値は NULL です。この文字列の最大長は、null 終端文字を含めて 256 文字です。
pwzCommentLPWSTR8/4+40+28ピアグラフを説明するために使用するコメントを指定します。このメンバーは省略可能で、NULL を指定できます。既定値は NULL です。この文字列の最大長は、null 終端文字を含めて 512 文字です。
ulPresenceLifetimeDWORD4+48+32プレゼンスレコードが期限切れになるまでの秒数を指定します。既定値は 300 秒 (5 分) です。ulPresenceLifetime の値は 300 秒未満に設定しないでください。このメンバーを既定値の 300 秒 (5 分) より小さい値に設定すると、未定義の動作が発生する可能性があります。
cPresenceMaxDWORD4+52+36

Peer Infrastructure がピアグラフ内に同時に保持するプレゼンスレコードの数を指定します。プレゼンスが公開されているノードは、PeerGraphEnumNodes によって他のすべてのノードから列挙できます。ユーザーのプレゼンスレコードを公開する方法は、次の表に示す値のいずれかを指定して決定します。

Value Description
-1 すべてのユーザーのプレゼンスレコードが自動的に公開されます。
0 プレゼンスレコードは自動的に公開されません。
1-N 最大 N 個のプレゼンスレコードが同時に公開されます。公開されるプレゼンスレコードは、Peer Graphing Infrastructure によってランダムに選択されます。

公式ドキュメント

PEER_GRAPH_PROPERTIES 構造体は、ピアグラフのポリシー、ID、スコープなどの情報を格納します。

解説(Remarks)

アプリケーションは、PeerGraphSetPresence を使用して、Peer Graphing Infrastructure にプレゼンス情報を強制的に公開させることができます。

PeerGraphSetProperties を呼び出すときに更新できるのは、PEER_GRAPH_PROPERTIES の特定のフィールドのみです。更新できるメンバーは次のとおりです。

残りのメンバーは変更できません。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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: uint32
struct 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