共用方式為

PeerGroupCreatePasswordInvitation 函式 (p2p.h)

  • 發行項

PeerGroupCreatePasswordInvitation 函式會傳回 XML 字串，供指定的對等用來聯結具有相符密碼的群組。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreatePasswordInvitation(
  [in]  HGROUP hGroup,
  [out] PWSTR  *ppwzInvitation
);

參數

[in] hGroup

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

[out] ppwzInvitation

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

此函式需要在傳遞至 PeerGroupCreate的PEER_GROUP_PROPERTIES結構上設定下列字段。

  • pwzGroupPassword。 此欄位必須包含用來驗證加入對等群組之對等的密碼。
  • groupPasswordRole。 此欄位必須包含需要密碼之角色的 GUID， (系統管理員或對等) 。
  • dwAuthenticationSchemes。 此欄位必須設定 PEER_GROUP_PASSWORD_AUTHENTICATION旗標 (0x00000001) 。

傳回值

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

傳回碼 Description
E_INVALIDARG
 其中一個參數無效。
E_OUTOFMEMORY
 記憶體不足，無法執行指定的作業。
PEER_E_GROUP_NOT_READY
 對等群組不是可以新增記錄的狀態。 例如， 呼叫PeerGroupJoin ，但與群組資料庫的同步處理尚未完成。
PEER_E_CHAIN_TOO_LONG
 GMC 鏈結超過24位系統管理員或成員。 如需 GMC 鏈結的詳細資訊，請參閱 群組安全性的運作 方式檔。
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