次の方法で共有


IDirectPlay8LobbyClient::SetConnectionSettings メソッド

IDirectPlay8LobbyClient::SetConnectionSettings メソッド

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

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

構文

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

パラメータ

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

戻り値

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

DPNERR_INVALIDPARAM メソッドに渡された 1 つ以上のパラメータが無効である。
DPNERR_INVALIDOBJECT Microsoft® DirectPlay® オブジェクトのポインタは無効である。
DPNERR_INVALIDFLAGS このメソッドに渡されたフラグは無効である。