Platform SDK: DirectX

DirectPlayLobby3.RunApplication

DirectPlayLobby3.RunApplication メソッドは、アプリケーションを開始し、そのアプリケーションをセッションに接続するために必要な情報をすべて渡す。このメソッドは、ロビー クライアントによって使用される。

object.RunApplication( _
    connection As DirectPlayLobbyConnection, _
    receiveEvent As Long) As Long

パラメータ

object
DirectPlayLobby3 オブジェクトを表すオブジェクト式。
connection
ユーザーにダイアログ ボックスを表示せずに、開始するアプリケーションと、セッションのインスタンスに接続する方法を指定するために必要な情報をすべて含む、DirectPlayLobbyConnection インターフェイス。
receiveEvent
ロビー メッセージを受信したときに設定される同期イベントへのハンドル。このイベントは、後で DirectPlayLobby3.SetLobbyMessageEvent メソッドを使用して変更することができる。

戻り値

開始されたアプリケーションの ID を返す。ロビー クライアントは、このアプリケーション ID を保存して、DirectPlayLobby3.SendLobbyMessage メソッドおよび DirectPlayLobby3.ReceiveLobbyMessage メソッドの呼び出しで使用できるようにする必要がある。

エラー コード

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

DPERR_CANTCREATEPROCESS
DPERR_GENERIC
DPERR_INVALIDINTERFACE
DPERR_INVALIDOBJECT
DPERR_INVALIDPARAMS
DPERR_OUTOFMEMORY
DPERR_UNKNOWNAPPLICATION

注意

このメソッドは、アプリケーション プロセスが作成された後に戻る。ロビー クライアントは、アプリケーションの状態を示すシステム メッセージを受信する。ロビー クライアントがセッションをホストするアプリケーションを起動している場合は、DPLSYS_DPLAYCONNECTSUCCEEDED システム メッセージを受信してから、そのセッションに参加するほかのアプリケーションを起動する必要がある。アプリケーションがセッションを作成または参加できなかった場合は、DPLSYS_DPLAYCONNECTFAILED メッセージが生成される。また、ロビー クライアントは、アプリケーションが接続設定を読み取ったときに DPLSYS_CONNECTIONSETTINGSREAD システム メッセージを受信し、アプリケーションが終了したときに DPLSYS_APPTERMINATED システム メッセージを受信する。

ロビー クライアントは、DPLSYS_CONNECTIONSETTINGSREAD システム メッセージを受信するまで、DirectPlayLobby3 オブジェクトを解放しないことが重要である。ロビー クライアントは、ReceiveLobbyMessage メッセージを受信するまでループで確認するか、または同期イベントを提供することができる。

参照

DirectPlayLobby3.GetConnectionSettingsDirectX7.CreateEvent