peerGroupOpenDirectConnection 函数 (p2p.h)

项目
08/25/2023

PeerGroupOpenDirectConnection 函数与对等组中的另一个对等机建立直接连接。

语法

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

parameters

[in] hGroup

托管直接连接的对等组的句柄。此句柄由 PeerGroupCreate、 PeerGroupOpen 或 PeerGroupJoin 函数返回。此参数是必需的。

[in] pwzIdentity

指向包含对等连接到的标识的 Unicode 字符串的指针。此参数是必需的。

[in] pAddress

指向包含对等连接到的 IPv6 地址的 PEER_ADDRESS 结构的指针。此参数是必需的。

[out] pullConnectionId

标识直接连接的无符号 64 位整数。在引发 PEER_GROUP_EVENT_DIRECT_CONNECTION 事件并指示另一对等方已接受连接之前，无法假定此 ID 值有效。此参数是必需的。

返回值

如果操作成功，则返回 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。

要求


最低受支持的客户端	带 SP2 的 Windows XP [仅限桌面应用]，带 SP1 的 Windows XP 以及适用于 Windows XP 的高级网络包
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	p2p.h
Library	P2P.lib
DLL	P2P.dll