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