DPMSG_CREATEPLAYERORGROUP

The DPMSG_CREATEPLAYERORGROUP structure contains information for the DPSYS_CREATEPLAYERORGROUP system message. The system sends this message when players and groups are created in a session.

DirectPlay generates this message and sends it to each player when a new player or group is created in a session.

typedef struct{
    DWORD  dwType;
    DWORD  dwPlayerType;
    DPID   dpId;
    DWORD  dwCurrentPlayers;
    LPVOID lpData;
    DWORD  dwDataSize;
    DPNAME dpnName;
    DPID   dpIDParent;
    DWORD  dwFlags;
} DPMSG_CREATEPLAYERORGROUP, FAR *LPDPMSG_CREATEPLAYERORGROUP;

dwType

A DWORD that identifies the message. This member must be set to DPSYS_CREATEPLAYERORGROUP.

dwPlayerType

A DWORD that indicates whether the message applies to a player (DPPLAYERTYPE_PLAYER) or a group (DPPLAYERTYPE_GROUP).

dpId

ID of a player or group created.

dwCurrentPlayers

Current number of players in the session before this player was created.

lpData

Pointer to any application-specific, remote data associated with this player or group. If this member is NULL, there is no remote data.

dwDataSize

Size of the data contained in the buffer referenced by lpData.

dpnName

Structure containing the name of the player or group.

dpIDParent

ID of the parent group if this message is caused by a call to IDirectPlay4::CreateGroupInGroup; otherwise, the value is 0.

dwFlags

Player or group flags.

DPGROUP_HIDDEN

Set when a hidden group is created.

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::CreateGroup, IDirectPlay4::CreatePlayer, IDirectPlay4::CreateGroupInGroup