PeerDistGetStatusEx 函数 (peerdist.h)

PeerDistGetStatusEx 函数返回对等分发服务的当前状态和功能。

语法

DWORD PeerDistGetStatusEx(
  [in]      PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in, out] PEERDIST_STATUS_INFO     *pPeerDistStatus
);

[in] hPeerDist

PeerDistStartup 返回的PEERDIST_INSTANCE_HANDLE。

[in, out] pPeerDistStatus

指向包含对等分发服务的当前状态和功能的 PEERDIST_STATUS_INFO 结构的指针。

如果函数成功，则返回值 ERROR_SUCCESS。

组策略更改可能会导致对等分发服务进入可用、不可用或禁用状态。根据此转换的结果状态，调用方有权访问的内容、内容信息或流句柄可能不再起作用。如果是这种情况，调用方必须通过调用相应的对等分布 API 显式关闭句柄。