PeerDistStartup 函数 (peerdist.h)
PeerDistStartup 函数创建一个新的对等分布实例句柄,该句柄必须传递给所有其他对等分发 API。
语法
DWORD PeerDistStartup(
[in] DWORD dwVersionRequested,
[out] PPEERDIST_INSTANCE_HANDLE phPeerDist,
[out, optional] PDWORD pdwSupportedVersion
);
参数
[in] dwVersionRequested
包含应用程序请求的对等分发的最低版本。 高序字节指定次要版本号;低序字节指定主版本号。
[out] phPeerDist
指向 PEERDIST_INSTANCE_HANDLE变量的 指针,该变量在成功后会收到新创建的句柄。
[out, optional] pdwSupportedVersion
指向变量的指针,如果不是 NULL,则包含对等分发系统支持的最大版本号。 高序字节指定次要版本号;低序字节指定主版本号。
返回值
如果函数成功,则返回值 ERROR_SUCCESS。 否则,该函数返回以下值之一:
返回代码 | 说明 |
---|---|
|
一个或多个参数无效。 |
|
客户端 DLL 不支持请求的版本。 |
注解
必须在任何其他对等分发函数之前调用 PeerDistStartup。 不再需要时,应通过调用 PeerDistShutdown 关闭 PeerDistStartup 返回的句柄。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 专业版 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | peerdist.h |
Library | PeerDist.lib |
DLL | PeerDist.dll |