Microsoft DirectX 8.0 (C++)

IDirectPlay8LobbyClient::SetConnectionSettings

Sets the connection settings to be associated with the specified connection. Calling this method will generate a DPL_MSGID_CONNECTION_SETTINGS message to be sent to the client specified by hConnection.

When you set connection settings, the lobby application will add a reference to each of the address objects specified in the call.

HRESULT SetConnectionSettings(
const DPNHANDLE hConnection,
const DPL_CONNECTION_SETTINGS *const pdplConnectSettings,
const DWORD dwFlags
);

Parameters

hConnection
Handle to the connection to set the settings for. You may also specify the following flag.
DPLHANDLE_ALLAPPLICATIONS
The connection settings will be updated for all the lobbied applications you are connected to.
pdplConnectSettings
Pointer to a DPL_CONNECTION_SETTINGS structure containing the settings associated with the specified connection.
dwFlags
Reserved, must be 0.

Return Values

Returns S_OK if successful, or one of the following error values.

DPNERR_INVALIDPARAM
DPNERR_INVALIDOBJECT
DPNERR_INVALIDFLAGS

Requirements

  Windows NT/2000: Available as a redistributable for Windows 2000 and later.
  Windows 95/98: Available as a redistributable for Windows 95 and later.
  Header: Declared in Dplobby8.h.