DPN_PLAYER_INFO

Describes static player information.

typedef struct _DPN_PLAYER_INFO{
    DWORD  dwSize;
    DWORD  dwInfoFlags;
    PWSTR  pwszName;
    PVOID  pvData;
    DWORD  dwDataSize;
    DWORD  dwPlayerFlags;
} DPN_PLAYER_INFO, *PDPN_PLAYER_INFO;

Members

dwSize

Variable of type DWORD describing the size of this structure.

dwInfoFlags

Variable of type DWORD containing flags that specify the type of information contained in this structure. When a GetPlayerInfo method returns, the dwInfoFlags member of the DPN_PLAYER_INFO will always have both flags set, even if the corresponding pointers are set to NULL. These flags are used when calling IDirectPlay8Peer::SetPeerInfo, to notify Microsoft® DirectPlay® which values have changed.

DPNINFO_NAME

The pwszName member contains valid data.

DPNINFO_DATA

The pvData member contains valid data.

pwszName

Pointer to a variable of type PWSTR specifying the Unicode name of the player.

pvData

Pointer to the data describing the player.

dwDataSize

Variable of type DWORD that specifies the size of the data contained in the pvData member.

dwPlayerFlags

Variable of type DWORD that may contain one of the following flags.

DPNPLAYER_LOCAL

This information is for the local player.

DPNPLAYER_HOST

This player is the host for the application.

Remarks

When using this structure in the IDirectPlay8Peer::GetPeerInfo and IDirectPlay8Server::GetClientInfo methods, dwInfoFlags must be set to 0.

When using this structure in the IDirectPlay8Client::SetClientInfo, IDirectPlay8Peer::SetPeerInfo, or IDirectPlay8Server::SetServerInfo methods, dwPlayerFlags should be set to zero.

Requirements

  Windows NT/2000/XP: Available as a redistributable for Windows 2000 and later.
  Windows 98/Me: Available as a redistributable for Windows 98 and later.
  Header: Declared in Dplay8.h.