PeerDistGetStatus 函数 (peerdist.h)

PeerDistGetStatus 函数返回对等分发服务的当前状态。

语法

DWORD PeerDistGetStatus(
  [in]  PEERDIST_INSTANCE_HANDLE hPeerDist,
  [out] PEERDIST_STATUS          *pPeerDistStatus
);

[in] hPeerDist

PeerDistStartup 返回的PEERDIST_INSTANCE_HANDLE。

[out] pPeerDistStatus

指向 PEERDIST_STATUS 枚举的指针，该枚举在操作成功时接收对等分发服务的当前状态。

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

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