PeerDistServerOpenContentInformationEx 函数 (peerdist.h)
PeerDistServerOpenContentInformationEx 函数将打开PEERDIST_CONTENTINFO_HANDLE。 客户端使用 句柄检索内容信息。
语法
DWORD PeerDistServerOpenContentInformationEx(
[in] PEERDIST_INSTANCE_HANDLE hPeerDist,
[in] DWORD cbContentIdentifier,
[in] PBYTE pContentIdentifier,
ULONGLONG ullContentOffset,
ULONGLONG cbContentLength,
[in] PEERDIST_RETRIEVAL_OPTIONS *pRetrievalOptions,
[in, optional] HANDLE hCompletionPort,
[in, optional] ULONG_PTR ulCompletionKey,
[out] PPEERDIST_CONTENTINFO_HANDLE phContentInfo
);
参数
[in] hPeerDist
PeerDistStartup 返回的PEERDIST_INSTANCE_HANDLE。
[in] cbContentIdentifier
内容标识符的长度（以字节为单位）。
[in] pContentIdentifier
指向包含内容标识符的缓冲区的指针。
ullContentOffset
与请求其内容信息句柄的已发布内容的开头的偏移量。
cbContentLength
从请求内容信息的 ullContentOffset) 开始 (内容的长度（以字节为单位）。
[in] pRetrievalOptions
指定用于检索内容信息的其他选项 的PEER_RETRIEVAL_OPTIONS 结构。
[in, optional] hCompletionPort
用于检索异步函数的完成通知的完成端口的句柄。 若要创建完成端口，请使用 CreateIoCompletionPort 函数。 此参数可以为 NULL。
[in, optional] ulCompletionKey
要通过 GetQueuedCompletionStatus 函数的 lpCompletionKey 参数返回的值。 当 hCompletionPort 为 NULL 时，将忽略此参数。
[out] phContentInfo
用于检索内容信息的句柄。
返回值
如果函数成功，则返回值 ERROR_SUCCESS。
注解
如果函数成功， phContentInfo 接收的句柄可以传递给
PeerDistServerRetrieveContentInformation 函数用于检索内容信息。
必须通过 PeerDistServerCloseContentInformation 函数关闭句柄。
如果 ullContentOffset 和 cbContentLength 均为零，则将检索整个内容的内容信息。
pRetrievalOptions 参数可用于指定请求客户端配置为处理的内容信息版本范围。 这使客户端能够检索内容信息结构的适用版本。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | peerdist.h |
另请参阅
PeerDistServerCloseContentInformation