Platform SDK: DirectX |
IDirectPlayLobby3::RunApplication メソッドは、アプリケーションを起動して、それをセッションに接続するために必要なすべての情報をそのアプリケーションに渡す。このメソッドは、ロビー クライアントにより使用される。
HRESULT RunApplication( DWORD dwFlags, LPDWORD lpdwAppID, LPDPLCONNECTION lpConn, HANDLE hReceiveEvent );
成功した場合は DP_OK を返す。失敗した場合は、次のエラー値のいずれかを返す。
DPERR_CANTCREATEPROCESS |
DPERR_GENERIC |
DPERR_INVALIDINTERFACE |
DPERR_INVALIDOBJECT |
DPERR_INVALIDPARAMS |
DPERR_OUTOFMEMORY |
DPERR_UNKNOWNAPPLICATION |
このメソッドは、アプリケーション プロセスが作成された後で戻る。ロビー クライアントは、アプリケーションのステータスを示すシステム メッセージを受け取る。ロビー クライアントがセッションのホストであるアプリケーションを起動している場合、セッションに参加するその他のアプリケーションを起動するときは、DPLSYS_DPLAYCONNECTSUCCEEDED システム メッセージを受け取るまで待ってから処理を行う。アプリケーションがセッションを作成したり、参加したりできない場合は、DPLSYS_DPLAYCONNECTFAILED メッセージが生成される。またロビー クライアントは、アプリケーションが接続設定を読み取ったときは DPLSYS_CONNECTIONSETTINGSREAD システム メッセージを、アプリケーションが終了したときは DPLSYS_APPTERMINATED システム メッセージを受け取る。
ロビー クライアントが DPLSYS_CONNECTIONSETTINGSREAD システム メッセージを受け取る前に、その IDirectPlayLobby3 インターフェイスを解放しないことは重要である。ロビー クライアントは、メッセージを受信するまで IDirectPlayLobby3::ReceiveLobbyMessage をループ処理でチェックすることも、同期イベントを指定することもできる。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : Dplobby.h で宣言。
インポート ライブラリ : dplayx.lib を使用。
IDirectPlayLobby3::ReceiveLobbyMessage、IDirectPlayLobby3::GetConnectionSettings,、IDirectPlayLobby3::SetLobbyMessageEvent