IDirectPlayLobby2::SetConnectionSettings

Modifies the DPLCONNECTION structure, which contains all the information needed to start and connect an application.

HRESULT SetConnectionSettings(
DWORD dwFlags,
DWORD dwAppID,
LPDPLCONNECTION lpConn
);

Parameters

dwFlags

Reserved; must be zero.

dwAppID

When called from a lobby client (that communicates with several applications), this parameter identifies which application's connection settings to retrieve. When called from an application (that communicates with only one lobby client), this parameter must be zero. This ID is obtained by using the IDirectPlayLobby2::RunApplication method.

lpConn

Pointer to a DPLCONNECTION structure that contains all the information necessary to specify which application to start and how to get it connected to a session instance without displaying any user dialog boxes.

Return Values

Returns DP_OK if successful, or one of the following error values otherwise:

DPERR_GENERIC

DPERR_INVALIDINTERFACE

DPERR_INVALIDOBJECT

DPERR_INVALIDPARAMS

DPERR_OUTOFMEMORY

See Also

IDirectPlayLobby2::GetConnectionSettings