PEER_GRAPH_PROPERTIES 構造体 (p2p.h)

PEER_GRAPH_PROPERTIES構造体には、ピア グラフ、ID、スコープ、およびその他の情報のポリシーに関するデータが含まれています。

構文

typedef struct peer_graph_properties_tag {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwScope;
  DWORD dwMaxRecordSize;
  PWSTR pwzGraphId;
  PWSTR pwzCreatorId;
  PWSTR pwzFriendlyName;
  PWSTR pwzComment;
  ULONG ulPresenceLifetime;
  ULONG cPresenceMax;
} PEER_GRAPH_PROPERTIES, *PPEER_GRAPH_PROPERTIES;

メンバー

dwSize

このデータ構造のサイズをバイト単位で指定します。 dwSize メンバーは、PeerGraphCreate を呼び出す前に、PEER_GRAPH_PROPERTIESのサイズに設定する必要があります。 このメンバーは必須です。 既定値はありません。

dwFlags

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

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

dwScope

ピア グラフ ID が発行されるスコープを指定します。 既定値は global です。 有効な値を次の表に示します。

説明
PEER_GRAPH_SCOPE_GLOBAL スコープにはインターネットが含まれます。
PEER_GRAPH_SCOPE_LINK_LOCAL スコープはローカル サブネットに制限されます。
PEER_GRAPH_SCOPE_SITE_LOCAL スコープは、企業イントラネットなどのサイトに制限されます。

dwMaxRecordSize

ピア グラフに追加できる最大のレコードを示す値を指定します。 有効な値は 0 (0) です。これは、既定の最大レコード サイズ (60 メガバイト)、および 1024 バイトから 60 メガバイトの任意の値が使用されることを示します。

pwzGraphId

ピア グラフの一意識別子を指定します。 この ID は、コンピューターとユーザーのペアに対して一意である必要があります。 このメンバーは必須であり、既定値はありません。 文字列値が 256 文字 (null 終端記号を含む) を超える場合は、エラーが返されます。

pwzCreatorId

ピア グラフの作成者の一意識別子を指定します。 このメンバーは必須であり、既定値はありません。 文字列値が 256 文字 (null 終端記号を含む) を超える場合は、エラーが返されます。

pwzFriendlyName

ピア グラフのフレンドリ名を指定します。 このメンバーは省略可能であり、 NULL にすることができます。 既定値は NULL です。 この文字列の最大長は、null 終端記号を含めて 256 文字です。

pwzComment

ピア グラフを記述するために使用するコメントを指定します。 このメンバーは省略可能であり、 NULL にすることができます。 既定値は NULL です。 この文字列の最大長は、null 終端記号を含めて 512 文字です。

ulPresenceLifetime

プレゼンス レコードの有効期限が切れるまでの秒数を指定します。 既定値は 300 秒 (5 分) です。 ulPresenceLifetime の値を 300 秒未満に設定しないでください。 このメンバーが 300 (5 分) の既定値より小さい値に設定されている場合、未定義の動作が発生する可能性があります。

cPresenceMax

ピア インフラストラクチャがピア グラフに一度に保持するプレゼンス レコードの数を指定します。 存在が公開されているノードは、 PeerGraphEnumNodes を使用して他のすべてのノードで列挙できます。 次の表に示す値のいずれかを指定して、ユーザーのプレゼンス レコードをパブリッシュする方法を指定します。

説明
-1 プレゼンス レコードは、すべてのユーザーに対して自動的に発行されます。
0 プレゼンス レコードは自動的には発行されません。
1-N 最大 N 個のプレゼンス レコードが一度に発行されます。 パブリッシュされたプレゼンス レコードは、ピア グラフ インフラストラクチャによってランダムに選択されます。

注釈

アプリケーションでは、 PeerGraphSetPresence を使用してピア グラフ インフラストラクチャにプレゼンス情報を強制的に発行させることができます。

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

  • pwzFriendlyName
  • pwzComment
  • ulPresenceLifetime
  • cPresenceMax
残りのメンバーは変更できません。

要件

要件
サポートされている最小のクライアント WINDOWS XP と SP2 [デスクトップ アプリのみ]、Windows XP SP1 と Advanced Networking Pack forWindows XP
サポートされている最小のサーバー サポートなし
Header p2p.h

こちらもご覧ください

PeerGraphCreate

PeerGraphGetProperties

PeerGraphSetProperties