通过

PeerDistServerOpenContentInformation 函数 (peerdist.h)

  • 项目

PeerDistServerOpenContentInformation 函数打开PEERDIST_CONTENTINFO_HANDLE。 客户端使用 句柄来检索内容信息。

语法

DWORD PeerDistServerOpenContentInformation(
  [in]           PEERDIST_INSTANCE_HANDLE     hPeerDist,
                 DWORD                        cbContentIdentifier,
  [in]           PBYTE                        pContentIdentifier,
                 ULONGLONG                    ullContentOffset,
                 ULONGLONG                    cbContentLength,
  [in, optional] HANDLE                       hCompletionPort,
  [in, optional] ULONG_PTR                    ulCompletionKey,
  [out]          PPEERDIST_CONTENTINFO_HANDLE phContentInfo
);

参数

[in] hPeerDist

PeerDistStartup 返回的PEERDIST_INSTANCE_HANDLE。

cbContentIdentifier

内容标识符的长度（以字节为单位）。

[in] pContentIdentifier

指向包含内容标识符的缓冲区的指针。

ullContentOffset

与请求其内容信息句柄的已发布内容的开头的偏移量。

cbContentLength

从请求其内容信息的 ullContentOffset) 开始的内容 (的长度（以字节为单位）。

[in, optional] hCompletionPort

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

[in, optional] ulCompletionKey

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

[out] phContentInfo

用于检索内容信息的句柄。

返回值

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

返回代码 说明
ERROR_INVALID_PARAMETER
 一个或多个参数无效。
ERROR_INVALID_HANDLE
 hPeerDist 句柄无效。
PEERDIST_ERROR_NOT_FOUND
 指定的内容标识符数据不会发布。
ERROR_ACCESS_DISABLED_BY_POLICY
 组策略禁用该功能。
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 服务不可用。

注解

如果函数成功， phContentInfo 接收的句柄可以传递给
PeerDistServerRetrieveContentInformation 函数，用于检索内容信息。 必须通过 PeerDistServerCloseContentInformation 函数关闭句柄。

如果 ullContentOffset 和 cbContentLength 均为零，则将检索整个内容的内容信息。

要求

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

另请参阅

PeerDistServerRetrieveContentInformation