Microsoft DirectX 9.0

IDirectPlay8LobbiedApplication::SetConnectionSettings Method

Sets the connection settings to be associated with the specified connection. Calling this method generates 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 );


[in] Handle to the connection to set the settings for. You may also specify the following flag.
The connection settings will be updated for all the lobby clients to which you are connected.
[in] Pointer to a DPL_CONNECTION_SETTINGS structure containing the settings associated with the specified connection.
[in] Reserved, must be 0.

Return Value

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

DPNERR_INVALIDPARAMOne or more of the parameters passed to the method are invalid.
DPNERR_INVALIDOBJECTThe Microsoft?DirectPlay?object pointer is invalid.
DPNERR_INVALIDFLAGSThe flags passed to this method are invalid.

© 2002 Microsoft Corporation. All rights reserved.