共用方式為

PeerGroupCreateInvitation 函式 (p2p.h)

  • 發行項

PeerGroupCreateInvitation 函式會傳回 XML 字串，供指定的對等用來聯結群組。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreateInvitation(
  [in]  HGROUP     hGroup,
  [in]  PCWSTR     pwzIdentityInfo,
  [in]  FILETIME   *pftExpiration,
  [in]  ULONG      cRoles,
  [in]  const GUID *pRoles,
  [out] PWSTR      *ppwzInvitation
);

參數

[in] hGroup

處理發出此邀請的對等群組。 這個句柄是由 PeerGroupCreate、PeerGroupOpen 或 PeerGroupJoin 函式傳回。 此為必要參數。

[in] pwzIdentityInfo

Unicode 字串的指標，其中包含 XML Blob (包括先前呼叫 PeerIdentityGetXML 與對等識別所傳回的 GMC) 。 或者，此參數也可以包含 PeerIdentityGetXML 所產生的 XML Blob 指標，使用 包含在PEER_CONTACT 中的對等資訊來產生對等聯繫人的邀請。

[in] pftExpiration

指定 UTC FILETIME 結構，其中包含邀請到期的特定日期和時間。 此值不能大於發出對等的剩餘存留期。 如果此參數為 NULL，邀請存留期會設定為可能的最大值 - 對等的剩餘存留期。

[in] cRoles

指定 pRoleInfo 中的角色計數。

[in] pRoles

指定可用角色組合集之 GUID 清單的指標。 可用的角色如下所示。

值 意義
PEER_GROUP_ROLE_ADMIN
 此角色可以發出邀請、發出認證，以及更新其他系統管理員的 GMC，以及作為對等群組的成員。
PEER_GROUP_ROLE_MEMBER
 此角色可以將記錄發佈至群組資料庫。

[out] ppwzInvitation

包含簽發者邀請的 Unicode 字串指標。 此邀請可由收件者傳遞至 PeerGroupJoin ，以便加入指定的對等群組。 若要以 PEER_INVITATION_INFO 結構傳回邀請的詳細數據，請將此字串傳遞至 PeerGroupParseInvitation。 若要釋放此數據，請將此指標傳遞至 PeerFreeData。

傳回值

如果作業成功，則傳回S_OK;否則，函式會傳回下列其中一個值。

傳回碼 Description
E_INVALIDARG
 其中一個參數無效。
E_OUTOFMEMORY
 記憶體不足，無法執行指定的作業。
PEER_E_GROUP_NOT_READY
 對等群組不是可以新增記錄的狀態。 例如， 呼叫PeerGroupJoin ，但尚未完成與群組資料庫的同步處理。
PEER_E_CHAIN_TOO_LONG
 GMC 鏈結超過24位系統管理員或成員。 如需 GMC 鏈結的詳細資訊，請參閱 Group Security Works 檔。
PEER_E_IDENTITY_DELETED
 以 pwzIdentityInfo 傳遞的數據適用於已刪除的身分識別，且不再有效。
PEER_E_NOT_AUTHORIZED
 呼叫這個方法的對等不是系統管理員。
PEER_E_NO_KEY_ACCESS
 拒絕存取身分識別或對等群組金鑰。 一般而言，這是因為包含使用者或計算機密鑰的資料夾 (ACL) 不正確的存取控制清單所造成。 當 ACL 手動重設時，就會發生這種情況。
 

密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。 這些錯誤前面會加上 CRYPT_* 並在 Winerror.h 中定義。

備註

對等無法為擔任的角色優於自己的對等建立邀請。 例如，成員角色中的對等無法為系統管理員角色中的對等建立邀請。

規格需求

需求 值
最低支援的用戶端 Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與 Windows XP 的進階網络套件
最低支援的伺服器 都不支援
目標平台 Windows
標頭 p2p.h
程式庫 P2P.lib
Dll P2P.dll

另請參閱

PEER_CONTACT

PeerGroupParseInvitation

PeerIdentityGetXML