通过

PeerDistServerRetrieveContentInformation 函数 (peerdist.h)

  • 项目

PeerDistServerRetrieveContentInformation 函数检索与 PeerDistServerOpenContentInformation 返回的句柄关联的编码内容信息。

语法

DWORD PeerDistServerRetrieveContentInformation(
  [in]      PEERDIST_INSTANCE_HANDLE    hPeerDist,
  [in]      PEERDIST_CONTENTINFO_HANDLE hContentInfo,
            DWORD                       cbMaxNumberOfBytes,
  [in, out] PBYTE                       pBuffer,
  [in]      LPOVERLAPPED                lpOverlapped
);

参数

[in] hPeerDist

PeerDistStartup 返回的PEERDIST_INSTANCE_HANDLE。

[in] hContentInfo

PeerDistServerOpenContentInformation 返回的句柄。

cbMaxNumberOfBytes

最多读取的字节数。

[in, out] pBuffer

指向接收内容信息数据的缓冲区的指针。

[in] lpOverlapped

指向 OVERLAPPED 结构的指针。 此函数不允许调用方在内容中指定起始偏移量。 偏移量隐式维护每个 hContentInfo。 Offset 和 OffsetHigh 是保留的，必须为零。

返回值

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

返回代码 说明
ERROR_INVALID_PARAMETER
 一个或多个参数无效。
ERROR_INVALID_HANDLE
 hPeerDist 或 hContentInfo 句柄无效。
PEERDIST_ERROR_NO_MORE
 已到达内容信息的 EOF。
ERROR_ACCESS_DISABLED_BY_POLICY
 组策略禁用该功能。
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 服务不可用。

注解

PeerDistServerRetrieveContentInformation 操作成功后，OVERLAPPED 结构的 Offset 和 OffsetHigh 字段将使用检索到的内容信息中的 ULONGLONG 偏移量填充。 OffsetHigh 成员将设置为偏移量较高的 32 位，而 Offset 成员将设置为偏移量较低的 32 位。

GetOverlappedResult 将使用传输的字节数填充 lpNumberOfBytesTransferred 。 如果调用方使用完成端口来处理对等分发 API 完成，则 GetQueuedCompletionStatus 的 lpNumberOfBytes 参数将填充传输的字节数。

要求

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

另请参阅

PeerDistServerOpenContentInformation

PeerDistStartup