Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
The EnumGroupPlayers method will enumerate players belonging to the specified group of an open session.
Remote sessions that are not password protected can have their players enumerated by using the DPENUMPLAYERS_SESSION flag and specifying the GUID of the remote session when there is no session open, but the enumeration call must occur after TDx_Play::EnumSessions() and before calling TDx_Play::Open() or TDx_Play::Close().
The TDx_Play::OnEnumGroupPlayers() event will be called for each player enumerated.
To enumerate players in a lobby session, you must be connected to it.
Error values that can be generated are:
DPERR_ACCESSDENIED
DPERR_CONNECTIONLOST
DPERR_INVALIDPARAMS
DPERR_INVALIDGROUP
DPERR_NOSESSIONS
DPERR_UNAVAILABLE
- Parameters
Group
The Group parameter identifies the group for which the players are to be enumerated.
Instance
The Instance parameter references the identifier of the session to be enumerated.
Ignored unless DPENUMPLAYERS_SESSION flag is set.
These GUIDs are obtained using TDx_Play::EnumSessions().
Context
The Context parameter references application defined data to be passed to the callback function for each player enumerated.
Flags
The Flags parameter defines flags indicating how to perform the enumeration.
The described effect applies when the flag is set.
The default setting of zero results in the enumeration of the players within a group in the current session.
Only players meeting all of the specified criteria will be enumerated.
-
DPENUMPLAYERS_LOCAL
Only enumerate locally created players.
DPENUMPLAYERS_OWNER
Only enumerate the group owner.
DPENUMPLAYERS_REMOTE
Only enumerate remotely created players.
DPENUMPLAYERS_SERVERPLAYER
Only enumerate the server player.
DPENUMPLAYERS_SESSION
Enumerate the players of the session identified by the Instance parameter.
Only usable when there is no session open and the target session is not a lobby session.
DPENUMPLAYERS_SPECTATOR
Only enumerate spectator players.
- See Also
- Top
TDx_Play_Library v2.00 Component Reference
|
|
|
[ TDx_Play::EnumGroupPlayers() ] [ next: EnumGroups() ] [ prev: EnumConnections() ] public:
virtual bool __fastcall EnumGroupPlayers( DPID pGroup, GUID* pInstance, void* pContext, dword pFlags );
TDX_PLAY::ENUMGROUPPLAYERS()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|