IDirectPlayLobby3::SetConnectionSettings

The IDirectPlayLobby3::SetConnectionSettings method modifies the settings used to start and connect an application.

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

Parameters

dwFlags

Reserved; must be 0.

dwAppID

When called from a lobby client (that communicates with several applications), this parameter identifies which application's connection settings to set. When called from an application (that communicates with only one lobby client), this parameter must be 0. This ID is obtained by using the IDirectPlayLobby3::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:

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.
  Import Library: Use dplayx.lib.

See Also

IDirectPlayLobby3::GetConnectionSettings