DPN_PLAYER_INFO Structure

Describes static player information.

Syntax

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 the IDirectPlay8Peer::GetPeerInfo or IDirectPlay8Server::GetClientInfo 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.

Structure Information

Header	dplay8.h
Minimum operating systems	Windows 98, Pocket PC 2002