DPMSG_DESTROYPLAYERORGROUP
Contains information for the DPSYS_DESTROYPLAYERORGROUP system message. DirectPlay generates this message and sends it to each player when a player or group is destroyed in a session.
Syntax
typedef struct{
DWORD dwType;
DWORD dwPlayerType;
DPID dpId;
LPVOID lpLocalData;
DWORD dwLocalDataSize;
LPVOID lpRemoteData;
DWORD dwRemoteDataSize;
DPNAME dpnName;
DPID dpIdParent;
DWORD dwFlags;
} DPMSG_DESTROYPLAYERORGROUP, FAR *LPDPMSG_DESTROYPLAYERORGROUP;
Members
- dwType
- A DWORD that identifies the message. This member is DPSYS_DESTROYPLAYERORGROUP.
- dwPlayerType
- A DWORD that identifies whether the message applies to a player (DPPLAYERTYPE_PLAYER) or group (DPPLAYERTYPE_GROUP).
- dpId
- ID of a player or group that has been destroyed.
- lpLocalData
- Pointer to the local data associated with this player or group.
- dwLocalDataSize
- Size, in bytes, of the local data.
- lpRemoteData
- Pointer to the remote data associated with this player or group.
- dwRemoteDataSize
- Size, in bytes, of the remote data.
- dpnName
- Structure containing the name of the player or group.
- dpIdParent
- ID of the parent group if the group being destroyed is a subgroup of the parent group (the group being destroyed was created by a call to IDirectPlay4::CreateGroupInGroup; otherwise, the value is zero.
- dwFlags
- Player or group flags. One or more of the following values:
- DPGROUP_HIDDEN
- Set when a hidden group is destroyed.
- DPGROUP_STAGINGAREA
- Set when a group that is a staging area is destroyed.
- DPPLAYER_SERVERPLAYER
- Set when the player being destroyed is a server player for client/server communications.
- DPPLAYER_SPECTATOR
- Set when the player destroyed is a spectator. A spectator player behaves exactly as a normal player except the player is flagged as a spectator.
Remarks
The DirectPlay 5.0 version of this structure added three members to the end, dpnName, dpIdParent, and dwFlags.
See Also
Top of Page
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.