DPLCONNECTION

The DPLCONNECTION structure contains the information needed to connect an application to a session.

typedef struct {
    DWORD            dwSize;
    DWORD            dwFlags;
    LPDPSESSIONDESC2 lpSessionDesc;
    LPDPNAME         lpPlayerName;
    GUID             guidSP;
    LPVOID           lpAddress;
    DWORD            dwAddressSize;
} DPLCONNECTION, FAR *LPDPLCONNECTION;
 

Members

dwSize

The size of the DPLCONNECTION structure, dwSize = sizeof(DPLCONNECTION). Your application must set this member before it uses this structure; otherwise, an error will result.

dwFlags

Indicates how to open a session.

DPLCONNECTION_CREATESESSION

Create a new session as described in the session description.

DPLCONNECTION_JOINSESSION

Join the existing session as described in the session description.

lpSessionDesc

Pointer to a DPSESSIONDESC2 structure describing the session to be created or the session to join.

lpPlayerName

Pointer to a DPNAME structure holding the name the player should be created with. This will be the name of the person registered in the lobby. The application can ignore this name.

guidSP

Globally unique identifier (GUID) of the service provider to use to connect to the session.

lpAddress

Pointer to a DirectPlay address that contains the information that the service provider needs to connect to a session.

dwAddressSize

Size, in bytes, of the address data.

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 dplobby.h.

See Also

IDirectPlayLobby3::RunApplication, IDirectPlayLobby3::GetConnectionSettings, IDirectPlayLobby3::SetConnectionSettings, DirectPlay Address