|Microsoft DirectX 9.0|
Retrieves a list of all the player and/or group identifiers for the application.
DPNID *const prgdpnid, DWORD *const pcdpnid, const DWORD dwFlags );
- [out] Pointer to an array that will be filled with the session's group and/or player identifiers.
- [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.
- [in] Flag that describes enumeration behavior. You can set one or both of the following flags.
- Return a list of player identifiers.
- Return a list of group identifiers.
Returns S_OK if successful, or one of the following error values.
DPNERR_BUFFERTOOSMALL The supplied buffer is not large enough to contain the requested data. DPNERR_INVALIDFLAGS The flags passed to this method are invalid.
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.