DPMSG_SETPLAYERORGROUPNAME

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.

Syntax

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

Members

dwType
Identifies the message. This member 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.

See Also

IDirectPlay4::GetPlayerName, IDirectPlay4::GetGroupName, IDirectPlay4::SetPlayerName, IDirectPlay4::SetGroupName

Top of Page Top of Page
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.