PeerGroupGetStatus function (p2p.h)

The PeerGroupGetStatus function retrieves the current status of a group.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetStatus(
  [in]  HGROUP hGroup,
  [out] DWORD  *pdwStatus
);

Parameters

[in] hGroup

Handle to a peer group whose status is returned. This handle is returned by the PeerGroupCreate, PeerGroupOpen, or PeerGroupJoin function. This parameter is required.

[out] pdwStatus

Pointer to a set of PEER_GROUP_STATUS flags that describe the status of a peer group.

Return value

Returns S_OK if the operation succeeds. Otherwise, the function returns one of the following values.

Return code Description
E_INVALIDARG
One or more of the parameters is invalid.
E_OUTOFMEMORY
There is not enough memory available to complete an operation.
PEER_E_INVALID_GROUP
The handle to a group is invalid.
 

Cryptography-specific errors can be returned from the Microsoft RSA Base Provider. These errors are prefixed with CRYPT_* and defined in Winerror.h.

Requirements

Requirement Value
Minimum supported client Windows XP with SP2 [desktop apps only],Windows XP with SP1 with the Advanced Networking Pack forWindows XP
Minimum supported server None supported
Target Platform Windows
Header p2p.h
Library P2P.lib
DLL P2P.dll

See also

PEER_GROUP_STATUS

PeerGroupCreate

PeerGroupJoin

PeerGroupOpen