PEER_INVITATION_INFO 構造体 (p2p.h)

  • [アーティクル]

PEER_INVITATION_INFO構造体は、ピア グループに参加するための招待に関する情報を定義します。 招待は Unicode 文字列として表されます。 この構造を取得するには、 PeerGroupCreateInvitation によって作成された XML 招待文字列を PeerGroupParseInvitation に渡します。

構文

typedef struct peer_invitation_info_tag {
  DWORD                            dwSize;
  DWORD                            dwFlags;
  PWSTR                            pwzCloudName;
  DWORD                            dwScope;
  DWORD                            dwCloudFlags;
  PWSTR                            pwzGroupPeerName;
  PWSTR                            pwzIssuerPeerName;
  PWSTR                            pwzSubjectPeerName;
  PWSTR                            pwzGroupFriendlyName;
  PWSTR                            pwzIssuerFriendlyName;
  PWSTR                            pwzSubjectFriendlyName;
  FILETIME                         ftValidityStart;
  FILETIME                         ftValidityEnd;
  ULONG                            cRoles;
  PEER_ROLE_ID                     *pRoles;
  ULONG                            cClassifiers;
  PWSTR                            *ppwzClassifiers;
  CERT_PUBLIC_KEY_INFO             *pSubjectPublicKey;
  PEER_GROUP_AUTHENTICATION_SCHEME authScheme;
} PEER_INVITATION_INFO, *PPEER_INVITATION_INFO;

メンバー

dwSize

この構造体のサイズをバイト単位で指定します。

dwFlags

0x00000000に設定する必要があります。

pwzCloudName

PNRP クラウド名を指定する Unicode 文字列へのポインター。

dwScope

ピア グループが登録されたスコープを指定します。

値 意味
PNRP_GLOBAL_SCOPE
 インターネットを含むグローバル スコープ。
PNRP_LOCAL_SCOPE
 ローカル スコープ。
PNRP_LINK_LOCAL_SCOPE
 リンク ローカル スコープ。

dwCloudFlags

PNRP クラウド機能を記述するフラグのセットを指定します。

値 意味
PNRP_CLOUD_NO_FLAGS
0
 フラグが設定されていません。
PNRP_CLOUD_NAME_LOCAL
1
 クラウド名は他のコンピューターでは使用できません。ローカルで定義されています。

pwzGroupPeerName

ピア グループのピア名を指定する Unicode 文字列へのポインター。

pwzIssuerPeerName

招待を発行するピアの PNRP 名を指定する Unicode 文字列へのポインター。

pwzSubjectPeerName

招待を受信するピアの PNRP 名を指定する Unicode 文字列へのポインター。

pwzGroupFriendlyName

ピア グループのフレンドリ (表示) 名を指定する Unicode 文字列へのポインター。

pwzIssuerFriendlyName

招待を発行するピアのフレンドリ (表示) 名を指定する Unicode 文字列へのポインター。

pwzSubjectFriendlyName

招待を受け取るピアのフレンドリ (表示) 名を指定する Unicode 文字列へのポインター。

ftValidityStart

招待が有効になるタイミングを示す UTC FILETIME 値を指定します。

ftValidityEnd

招待が無効になるタイミングを示す UTC FILETIME 値を指定します。

cRoles

pRoles に存在するロール GUID の数を指定します。

pRoles

使用可能なロールの組み合わせセットを指定する GUID のリストへのポインター。 使用可能なロールは次のとおりです。

値 意味
PEER_GROUP_ROLE_ADMIN
 このロールでは、招待の発行、メンバーシップの更新、ピア グループのプロパティの変更、レコードの発行と更新、他の管理者の GMC の更新を行うことができます。
PEER_GROUP_ROLE_MEMBER
 ロールは、ピア グループ データベースにレコードを発行できます。

cClassifiers

ppwzClassifiers にリストされている文字列値の数を含む符号なし整数値。 このフィールドは将来使用するために予約されています。

ppwzClassifiers

Unicode 文字列へのポインターの一覧。 このフィールドは将来使用するために予約されています。

pSubjectPublicKey

受信者 の返 された公開キーと、それが使用する暗号化アルゴリズムの種類を含むCERT_PUBLIC_KEY_INFO構造体へのポインター。

authScheme

Windows Vista 以降。 ピア グループの招待者の検証に使用される認証の種類を示す PEER_GROUP_AUTHENTICATION_SCHEME 列挙値。

要件

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

こちらもご覧ください

PeerGroupParseInvitation