PeerDistGetStatusEx function (peerdist.h)

The PeerDistGetStatusEx function returns the current status and capabilities of the Peer Distribution service.

Syntax

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

Parameters

[in] hPeerDist

A PEERDIST_INSTANCE_HANDLE returned by PeerDistStartup.

[in, out] pPeerDistStatus

A pointer to a PEERDIST_STATUS_INFO structure that contains the current status and capabilities of the Peer Distribution service.

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

Remarks

A Group Policy change can result in the Peer Distribution service moving to an available, unavailable, or disabled state. Depending on the resultant state of this transition, the content, content information, or stream handles the caller has access to may no longer function. If this is the case, the caller must explicitly close the handles by calling the appropriate Peer Distribution API.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header peerdist.h

See also

PEERDIST_STATUS

PEERDIST_STATUS_INFO