IDirectPlay8LobbiedApplication::GetConnectionSettings

Retrieves the set of connection settings for the specified connection. These settings can be set through a call to the IDirectPlay8LobbyClient::ConnectApplication, IDirectPlay8LobbyClient::SetConnectionSettings, or IDirectPlay8LobbiedApplication::SetConnectionSettings method.

When you get connection settings, a reference will be added for each address object that is returned to the user. Therefore, users must be sure to call Release on each address object when they are done with the structure.

HRESULT GetConnectionSettings(
const DPNHANDLE hLobbyClient,
DPL_CONNECTION_SETTINGS *const pdplSessionInfo,
DWORD* pdwInfoSize,
const DWORD dwFlags
);

Parameters

hLobbyClient

[in] Handle to the connection for which to retrieve the settings.

pdplSessionInfo

[out] Pointer to a DPL_CONNECTION_SETTINGS structure to receive the connection settings for the specified connection.

pdwInfoSize

[in,out] Pointer to a DWORD containing the size, in bytes, of the buffer specified in the pdplSessionInfo structure. If the buffer is not large enough to hold the connection settings, DPNERR_BUFFERTOOSMALL is returned and this value will be set to the required buffer size. On success, this value will contain the number of bytes written to the specified buffer.

dwFlags

[in] Reserved, must be 0.

Return Values

Returns S_OK if successful, or the following error value.

Requirements

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