共用方式為

PeerGroupPasswordJoin 函式 (p2p.h)

  • 發行項

PeerGroupPasswordJoin 函式會準備具有邀請的對等和正確的密碼，以在呼叫 PeerGroupConnect 或 PeerGroupConnectByAddress 之前加入受密碼保護的對等群組。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupPasswordJoin(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzInvitation,
  [in]  PCWSTR pwzPassword,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

參數

[in] pwzIdentity

Unicode 字串的指標，其中包含開啟指定對等群組的身分識別。 如果此參數為 NULL，實作會使用從 PeerIdentityGetDefault 取得的身分識別。

[in] pwzInvitation

Unicode 字串的指標，其中包含另一個對等所授與的 XML 邀請。 當邀請的對等呼叫 PeerGroupCreatePasswordInvitation 時，會建立具有密碼的邀請。 有關此邀請的特定詳細數據，包括群組建立者所設定的密碼，可藉由呼叫PeerGroupParseInvitation，以PEER_INVITATION_INFO結構的形式取得。 此為必要參數。

[in] pwzPassword

零終止 Unicode 字串的指標，其中包含驗證和加入對等群組所需的密碼。 此密碼必須符合邀請中指定的密碼。 此為必要參數。

[in] pwzCloud

Unicode 字串的指標，其中包含群組所在 PNRP 雲端的名稱。 預設值為 NULL，表示必須使用邀請中指定的雲端。

[out] phGroup

對等群組句柄的指標。 若要開始與群組通訊，請呼叫 PeerGroupConnect。 此為必要參數。

傳回值

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

傳回碼 Description
E_INVALIDARG
 其中一個參數無效。
E_OUTOFMEMORY
 記憶體不足，無法完成作業。
PEER_E_CLOUD_NAME_AMBIGUOUS
 雲端無法唯一探索，例如，多個雲端符合提供的名稱。
PEER_E_INVALID_PEER_NAME
 pwzIdentity 中指定的對等識別無效。
PEER_E_INVITATION_NOT_TRUSTED
 對等不信任邀請。 已變更或包含錯誤。
PEER_E_NO_CLOUD
 無法找到雲端。
PEER_E_UNSUPPORTED_VERSION
 目前版本的對等基礎結構不支持邀請。
PEER_E_NO_KEY_ACCESS
 拒絕對等身分識別或對等群組密鑰的存取。 一般而言，這是因為包含使用者或計算機密鑰的資料夾 (ACL) 不正確的存取控制清單所造成。 當 ACL 手動重設時，就會發生這種情況。
PEER_S_ALREADY_A_MEMBER
 本機對等嘗試根據密碼多次加入群組。
 

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

備註

如果參與的計算機之間發生時鐘扭曲，初始 PeerGroupPasswordJoin 函式可能仍會成功，而下列 PeerGroupConnect 呼叫可能會導致無法聯結，視扭曲的嚴重性而定。

規格需求

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

另請參閱

PeerGroupConnect

PeerGroupConnectByAddress