共用方式為

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

Unicode 字串的指標，指定發出邀請之對等的 PNRP 名稱。

pwzSubjectPeerName

Unicode 字串的指標，指定接收邀請之對等的 PNRP 名稱。

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 與適用於Windows XP 的進階網络套件
最低支援的伺服器 都不支援
標頭 p2p.h

另請參閱

PeerGroupParseInvitation