IDirectPlay8Server::EnumPlayersAndGroups Method

DirectPlay

 
Microsoft DirectX 9.0 SDK Update (Summer 2003)

IDirectPlay8Server::EnumPlayersAndGroups Method


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

Syntax

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 Value

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

DPNERR_BUFFERTOOSMALLThe supplied buffer is not large enough to contain the requested data.
DPNERR_INVALIDFLAGSThe flags passed to this method are invalid.

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.



© 2003 Microsoft Corporation. All rights reserved.