PeerDistClientOpenContent 函数 (peerdist.h)

项目
08/25/2023

PeerDistClientOpenContent 函数打开并返回PEERDIST_CONTENT_HANDLE。客户端使用内容句柄从对等分发服务检索数据。

语法

DWORD PeerDistClientOpenContent(
  [in]           PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in]           PCPEERDIST_CONTENT_TAG   pContentTag,
  [in, optional] HANDLE                   hCompletionPort,
  [in, optional] ULONG_PTR                ulCompletionKey,
  [out]          PPEERDIST_CONTENT_HANDLE phContentHandle
);

parameters

[in] hPeerDist

PeerDistStartup 返回的PEERDIST_INSTANCE_HANDLE。

[in] pContentTag

指向包含 16 字节客户端指定标识符的PEERDIST_CONTENT_TAG 结构的指针。此参数与 PeerDistClientFlushContent 函数一起使用。

[in, optional] hCompletionPort

可用于检索异步函数的完成通知的完成端口的句柄。若要创建完成端口，请使用 CreateIoCompletionPort 函数此参数可以为 NULL。

[in, optional] ulCompletionKey

要通过 GetQueuedCompletionStatus 函数的 lpCompletionKey 参数返回的值。 当 hCompletionPort 为 NULL 时，将忽略此参数。

[out] phContentHandle

指向变量的指针，该变量接收用于检索或添加数据的 PEERDIST_CONTENT_HANDLE 。

返回值

如果函数成功，则返回值 ERROR_SUCCESS。否则，该函数返回以下值之一：

返回代码	说明
ERROR_INVALID_PARAMETER	一个或多个参数无效。
ERROR_INVALID_HANDLE	hPeerDist 句柄无效。
ERROR_ACCESS_DISABLED_BY_POLICY	组策略禁用此功能。
PEERDIST_ERROR_SERVICE_UNAVAILABLE	服务不可用。

注解

客户端必须调用 PeerDistClientOpenContent 函数以获取以后可在以下函数中使用的 PEERDIST_CONTENT_HANDLE 句柄：

如果指定了可选的完成端口句柄，则它用于发布上面列出的异步函数的完成结果。

PeerDistClientOpenContent 函数调用返回的句柄必须由 PeerDistClientCloseContent 函数关闭。

要求


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