Microsoft DirectX 8.0 (C++)

IDirectPlay8LobbyClient::SetConnectionSettings

指定された接続に関連付ける接続設定を設定する。このメソッドを呼び出すと、hConnection で指定したクライアントに送信する DPL_MSGID_CONNECTION_SETTINGS メッセージが生成される。

接続設定を設定すると、呼び出しに指定した各アドレス オブジェクトにロビー アプリケーションが参照を追加する。

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

パラメータ

hConnection
設定を設定する接続のハンドル。次のフラグも指定できる。
DPLHANDLE_ALLAPPLICATIONS
接続設定が、接続しているすべてのロビー アプリケーションに対して更新される。
pdplConnectSettings
指定された接続に関連付けられた設定を保持する DPL_CONNECTION_SETTINGS 構造体へのポインタ。
dwFlags
将来の使用に備えて予約されているので、0 に設定しておく。

戻り値

成功した場合は S_OK を返し、失敗した場合は次のいずれかのエラー値を返す。

DPNERR_INVALIDPARAM
DPNERR_INVALIDOBJECT
DPNERR_INVALIDFLAGS

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : Dplobby8.h で宣言。