DPSESSIONDESC

typedef struct {

DWORD dwSize;

GUID guidSession;

DWORD dwSession;

DWORD dwMaxPlayers;

DWORD dwCurrentPlayers;

DWORD dwFlags;

char szSessionName[DPSESSIONNAMELEN];

char szUserField[DPUSERRESERVED];

DWORD dwReserved1;

char szPassword[DPPASSWORDLEN];

DWORD dwReserved2;

DWORD dwUser1;

DWORD dwUser2;

DWORD dwUser3;

DWORD dwUser4;

} DPSESSIONDESC;

typedef DPSESSIONDESC FAR *LPDPSESSIONDESC;

Contains a description of the capabilities of a DirectPlay session.

dwSize

Size of this structure, in bytes. Must be initialized before the structure is used.

guidSession

Globally unique identifier (GUID) for the game. It identifies the game so that DirectPlay connects only to other machines playing the same game.

dwSession

Session identifier of the session that has been created or opened.

dwMaxPlayers

Maximum number of players and groups allowed in this session. This member is ignored if the application is not creating a new session.

dwCurrentPlayers

Current players and groups in the session.

dwFlags

Specifies one of the control flags:

DPOPEN_CREATESESSION

Creates a new session described by the DPSESSIONDESC structure.

DPOPEN_OPENSESSION

Opens the session identified by the dwSession member.

DPENUMSESSIONS_ALL

Enumerates all active sessions connected to this DirectPlay object, regardless of their occupancy, passwords, or the IDirectPlay::EnableNewPlayers method's status.

szSessionName

String containing the name of the session.

szUserField

String containing user data.

dwReserved1

Reserved for future use.

szPassword

String containing the optional password that, once set up, is required to join this session.

dwReserved2

Reserved for future use.

dwUser1, dwUser2, dwUser3, dwUser4

User-specific data for the game or session.