通过

PeerDistClientAddContentInformation 函数 (peerdist.h)

  • 项目

PeerDistClientAddContentInformation 函数添加与 PeerDistClientOpenContent 打开的内容句柄关联的内容信息。

语法

DWORD PeerDistClientAddContentInformation(
  [in] PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in] PEERDIST_CONTENT_HANDLE  hContentHandle,
       DWORD                    cbNumberOfBytes,
  [in] PBYTE                    pBuffer,
  [in] LPOVERLAPPED             lpOverlapped
);

参数

[in] hPeerDist

PeerDistStartup 返回的PEERDIST_INSTANCE_HANDLE。

[in] hContentHandle

由 PeerDistClientOpenContent 打开的PEERDIST_CONTENT_HANDLE。

cbNumberOfBytes

pBuffer 数组中的字节数。

[in] pBuffer

指向包含内容信息的缓冲区的指针。 此缓冲区必须在添加操作期间保持有效。 在完成添加操作之前，调用方不得使用此缓冲区。

[in] lpOverlapped

指向 OVERLAPPED 结构的指针。 OVERLAPPED 结构的内部成员包含异步操作的完成状态。 Offset 和 OffsetHigh 是保留的，必须为 0。

返回值

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

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

注解

为了从对等分发服务检索内容数据，客户端必须通过调用 PeerDistClientAddContentInformation 函数添加从内容服务器接收的内容信息。 添加所有内容信息数据后，必须调用 PeerDistClientCompleteContentInformation 函数。 PeerDistClientCompleteContentInformation 完成后，客户端可以调用 PeerDistClientStreamRead 或 PeerDistClientBlockRead 从对等分发系统检索数据。

在单个内容句柄上多次调用此函数时，调用方必须等待每个操作完成，然后才能进行下一次调用。

应用程序不限于使用单个 PeerDistClientAddContentInformation API 调用添加内容信息，因为可以在内容信息可用时添加部分内容信息。 当有更多内容信息可用时，应用程序可以再次调用 PeerDistClientAddContentInformation。 应用程序添加完整个内容信息后，必须调用 PeerDistClientCompleteContentInformation。

要求

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

另请参阅

PeerDistClientCompleteContentInformation

PeerDistClientOpenContent

PeerDistStartup