DPMSG_DESTROYPLAYERORGROUP

The DPMSG_DESTROYPLAYERORGROUP structure 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.

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;

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—that is, the group being destroyed was created by a call to IDirectPlay4::CreateGroupInGroup. Otherwise the value is 0.

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.

Remarks

The version of this structure in DirectX 5.0 added three members to the end, dpnName, dpIdParent, and dwFlags.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dplay.h.

See Also

IDirectPlay4::DestroyGroup, IDirectPlay4::DestroyPlayer