##

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

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.