Platform SDK: DirectX

DirectPlayLobby3.WaitForConnectionSettings

DirectPlayLobby3.WaitForConnectionSettings メソッドは、アプリケーションを待機モードに設定する。待機モードでは、接続設定を待機する。アプリケーションが待機モードに設定されている場合、aDirectPlayLobby3.RunApplication メソッドを使用するロビー クライアントは、アプリケーションの新しいインスタンスを起動せず、既に待機モードで実行されているアプリケーションに接続設定を直接送信する。

アプリケーションは、DirectPlayLobby3.Connect メソッドを使用してセッションに接続することができる。

object.WaitForConnectionSettings(flags As CONST_DPLWAIT)

パラメータ

object
DirectPlayLobby3 オブジェクトを表すオブジェクト式。
flags
アプリケーションを待機モードに設定するか、または待機モードから解除する、CONST_DPLWAIT 列挙型のフラグ。デフォルト (flags = DPLWAIT_DEFAULT または 0) では、アプリケーションを待機モードに設定する。DPLWAIT_CANCEL を設定すると、アプリケーションを待機モードから解除する。ロビー クライアントから接続設定が送信されると、アプリケーションは直ちに待機モードから自動的に解除される。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DPERR_INVALIDFLAGS
DPERR_UNAVAILABLE

アプリケーションが待機モードに設定されていない場合に、待機モードをキャンセルするフラグを設定した場合は、DPERR_UNAVAILABLE を返す。

ロビー クライアントが RunApplication を使用すると、DirectPlay は、接続設定を待機しているアプリケーションのインスタンスを検索する。それが見つからない場合は、アプリケーションの新しいインスタンスを起動する。待機中のアプリケーションが見つかった場合は、DirectPlayLobby3.GetConnectionSettings メソッドを使用して接続設定を読み取り、Connect を使用してセッションに接続する。