DPLCONNECTION

---

Contains the information needed to connect an application to a session.

Syntax

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. Examine this member to determine if the fields added in DirectPlay version 5 are available.

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. For more information about the DirectPlay Address, see DirectPlay Address. For a list of Microsoft predefined address data types, see DirectPlay Address Data Types.

dwAddressSize

Size, in bytes, of the address data.

See Also

IDirectPlayLobby3::RunApplication, IDirectPlayLobby3::GetConnectionSettings, IDirectPlayLobby3::SetConnectionSettings

---

 Top of Page
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.