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。 否则,该函数返回以下值之一:

返回代码 说明
ERROR_INVALID_PARAMETER
一个或多个参数无效。
PEERDIST_ERROR_VERSION_UNSUPPORTED
客户端 DLL 不支持请求的版本。

注解

必须在任何其他对等分发函数之前调用 PeerDistStartup。 不再需要时,应通过调用 PeerDistShutdown 关闭 PeerDistStartup 返回的句柄。

要求

要求
最低受支持的客户端 Windows 7 专业版 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 peerdist.h
Library PeerDist.lib
DLL PeerDist.dll

另请参阅

PeerDistShutdown