DPMSG_SETPLAYERORGROUPNAME

The DPMSG_SETPLAYERORGROUPNAME structure contains information for the DPSYS_SETPLAYERORGROUPNAME system message. DirectPlay generates this message and sends it to each local player on the computer when the name of a player or group changes. This message will not be generated if the DPSESSION_NODATAMESSAGES flag is specified in the session description.

typedef struct {
    DWORD  dwType;
    DWORD  dwPlayerType;
    DPID   dpId;
    DPNAME dpnName;
} DPMSG_SETPLAYERORGROUPNAME, FAR *LPDPMSG_SETPLAYERORGROUPNAME;

dwType

Identifies the message. This value is always DPSYS_SETPLAYERORGROUPNAME.

dwPlayerType

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

dpId

ID of the player or group whose name changed.

dpnName

Structure containing the new name information for the player or group.

Remarks

It is not necessary for the application to save the dpnName from this message because it can be retrieved at any time using IDirectPlay4::GetPlayerName or IDirectPlay4::GetGroupName.

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::GetPlayerName, IDirectPlay4::GetGroupName, IDirectPlay4::SetPlayerName, IDirectPlay4::SetGroupName