IDirectPlay8Server::EnumPlayersAndGroups

Retrieves a list of all the player and/or group identifiers for the application.

HRESULT EnumPlayersAndGroups(
DPNID *const prgdpnid,
DWORD *const pcdpnid,
const DWORD dwFlags
);

Parameters

prgdpnid

[out] Pointer to an array that will be filled with the session's group and/or player identifiers.

pcdpnid

[in,out] Pointer to a variable of type DWORD that specifies the number of identifiers in the prgdpnid parameter. If the buffer is too small, this method returns DPNERR_BUFFERTOOSMALL and this parameter contains the number of entries that are required.

dwFlags

[in] Flag that describes enumeration behavior. You can set one or both of the following flags.

DPNENUM_PLAYERS

Return a list of player identifiers.

DPNENUM_GROUPS

Return a list of group identifiers.

Return Values

Returns S_OK if successful, or one of the following error values.

Remarks

Because group and player information changes frequently, the required buffer size returned may change between subsequent calls. Check and reallocate the buffer until the method succeeds.

Requirements

  Windows NT/2000/XP: Available as a redistributable for Windows 2000 and later.
  Windows 98/Me: Available as a redistributable for Windows 98 and later.
  Header: Declared in Dplay8.h.