PEER_GROUP_PROPERTIES 構造体 (p2p.h)

  • [アーティクル]

PEER_GROUP_PROPERTIES構造体には、ピア グループのメンバーシップ ポリシーに関するデータが含まれています。

構文

typedef struct peer_group_properties_tag {
  DWORD        dwSize;
  DWORD        dwFlags;
  PWSTR        pwzCloud;
  PWSTR        pwzClassifier;
  PWSTR        pwzGroupPeerName;
  PWSTR        pwzCreatorPeerName;
  PWSTR        pwzFriendlyName;
  PWSTR        pwzComment;
  ULONG        ulMemberDataLifetime;
  ULONG        ulPresenceLifetime;
  DWORD        dwAuthenticationSchemes;
  PWSTR        pwzGroupPassword;
  PEER_ROLE_ID groupPasswordRole;
} PEER_GROUP_PROPERTIES, *PPEER_GROUP_PROPERTIES;

メンバー

dwSize

構造体のサイズ (バイト単位)。

dwFlags

ピア グループの動作を記述するフラグをPEER_GROUP_PROPERTY_FLAGSします。 既定値は 0 です。これは、フラグが設定されていないことを示します。

pwzCloud

ピア グループが参加するピア名前解決プロトコル (PNRP) クラウドの名前を指定します。 このメンバーが NULL の場合、既定値は "global" です。

pwzClassifier

PNRP クラウド内での登録または解決のためのピア グループ ピア名の権限を識別するために使用される分類子を指定します。 このフィールドの最大サイズは 149 Unicode 文字です。 このメンバーには NULL を指定できます。

pwzGroupPeerName

PNRP サービスに登録されているピア グループの名前を指定します。 このフィールドの最大サイズは 137 Unicode 文字です。

pwzCreatorPeerName

ピア グループ作成者に関連付けられているピア名を指定します。 このフィールドの最大サイズは 137 Unicode 文字です。 この構造体メンバーが NULL の場合、実装では PeerIdentityGetDefault から取得した ID が使用されます。

pwzFriendlyName

ピア グループのフレンドリ (表示) 名を指定します。 このフィールドの最大サイズは 255 文字です。

pwzComment

ピア グループを記述するために使用されるコメントが含まれます。 このフィールドの最大サイズは 255 文字です。

ulMemberDataLifetime

ピア グループ メンバー データ (PEER_MEMBER) の有効期間を秒単位で指定します。 このフィールドの最小値は 8 時間で、最大値は 10 年です。 既定値は 2,419,200 秒、つまり 28 日です。

この値がゼロ (0) に設定されている場合、メンバー データの有効期間は最大です。これは、メンバーの資格情報を発行する管理者の有効期間の残り時間です。

ulPresenceLifetime

ピア グループに発行されたプレゼンス情報の有効期間を秒単位で指定します。 既定値は 300 秒です。 ulPresenceLifetime の値を 300 秒未満に設定しないでください。 このメンバーが 300 秒未満の既定値に設定されている場合は、未定義の動作が発生する可能性があります。

dwAuthenticationSchemes

Windows Vista 以降。 ピア グループPEER_GROUP_AUTHENTICATION_SCHEMEサポートされている認証の種類を示 す列挙値 の論理 OR。

pwzGroupPassword

Windows Vista 以降。 ピア グループへの参加を試みるピアの認証に使用されるパスワードを含む Unicode 文字列へのポインター。

groupPasswordRole

Windows Vista 以降。 認証にパスワードが必要なピア グループロールを示す GUID 値。

要件

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

こちらもご覧ください

PeerGroupCreate

PeerGroupGetProperties

PeerGroupSetProperties