Platform SDK: DirectX

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