DPMSG_CREATEPLAYERORGROUP

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;

Members

dwType

Identifies the message. This member must be set to DPSYS_CREATEPLAYERORGROUP.

dwPlayerType

Indicates whether the message applies to a player (DPPLAYERTYPE_PLAYER) or a group (DPPLAYERTYPE_GROUP).

dpId

The 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

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

dwFlags

The player or group flags.

Remarks

The DirectPlay 5 version of this structure has two members added to the end, dpIdParent and dwFlags.

See Also

IDirectPlay3::CreateGroup, IDirectPlay3::CreatePlayer, IDirectPlay3::CreateGroupInGroup