PeerGroupOpenDirectConnection 函式 (p2p.h)

發行項
03/15/2023

PeerGroupOpenDirectConnection函式會建立與對等群組中另一個對等的直接連線。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpenDirectConnection(
  [in]  HGROUP        hGroup,
  [in]  PCWSTR        pwzIdentity,
  [in]  PPEER_ADDRESS pAddress,
  [out] ULONGLONG     *pullConnectionId
);

參數

[in] hGroup

處理裝載直接連線的對等群組。 PeerGroupCreate、PeerGroupOpen或PeerGroupJoin函式會傳回此控制碼。此為必要參數。

[in] pwzIdentity

包含對等所連線之身分識別的 Unicode 字串指標。此為必要參數。

[in] pAddress

包含對等所連線之 IPv6 位址之PEER_ADDRESS 結構的指標。此為必要參數。

[out] pullConnectionId

識別直接連接的無符號 64 位整數。除非引發 PEER_GROUP_EVENT_DIRECT_CONNECTION 事件，並指出其他對等已接受連線，否則無法假設此識別碼值為有效。此為必要參數。

傳回值

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

傳回碼	描述
E_INVALIDARG	其中一個參數無效。
E_OUTOFMEMORY	記憶體不足，無法完成作業。
PEER_E_CONNECT_SELF	連線失敗，因為它是回送，也就是說，連接是在對等和本身之間。
PEER_E_NO_KEY_ACCESS	拒絕對等身分識別或對等群組金鑰的存取。這通常是由包含使用者或電腦金鑰的資料夾 (ACL) 不正確的存取控制清單所造成。當 ACL 已手動重設時，就會發生這種情況。

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

備註

使用這個函式開啟的每個直接連線都必須以PEER_GROUP_EVENT DATA結構關閉，其元件的狀態成員PEER_EVENT_CONNECTION_CHANGE_DATA結構設定為 PEER_CONNECTION_FAILED。

需求


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