DPMSG_SETPLAYERORGROUPDATA

The DPMSG_SETPLAYERORGROUPDATA message structure contains information for the DPSYS_SETPLAYERORGROUPDATA system message. DirectPlay generates this message and sends it to each player when the remote data 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;
    LPVOID lpData;
    DWORD  dwDataSize;
} DPMSG_SETPLAYERORGROUPDATA, FAR *LPDPMSG_SETPLAYERORGROUPDATA;

dwType

Identifies the message. This value is always DPSYS_SETPLAYERORGROUPDATA.

dwPlayerType

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

dpId

ID of the player or group whose data changed.

lpData

Pointer to an application-specific block of data.

dwDataSize

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

Remarks

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

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::SetPlayerData, IDirectPlay4::SetGroupData