Microsoft DirectX 8.0 (C++)

IDirectPlay8LobbyClient::ConnectApplication

ロビー対応アプリケーションを、DPL_CONNECT_INFO 構造体に指定されているセッションに接続する。アプリケーションが実行されていない場合、このメソッドを使用してアプリケーションを起動できる。

接続が成功すると、ロビー アプリケーションはメッセージ ハンドラに DPL_MSGID_CONNECT システム メッセージを生成する。

HRESULT ConnectApplication(
DPL_CONNECT_INFO *const pdplConnectionInfo,
const PVOID pvUserApplicationContext,
DPNHANDLE *const phApplication,
const DWORD dwTimeOut,
const DWORD dwFlags
);

パラメータ

pdplConnectionInfo
DPL_CONNECT_INFO 構造体へのポインタ。この構造体は接続先アプリケーションの GUID を含む、接続パラメータを記述する。
pvUserApplicationContext
ロビー クライアント用に定義されたコンテキスト値へのポインタ。この値は、ロビー クライアントのメッセージ ハンドラへの呼び出しで渡される。
phApplication
このメソッドが成功した場合に設定されるアプリケーション コンテキスト ハンドルを指定する DPNHANDLE へのポインタ。このハンドルは、アプリケーションとの通信に使用される。また、このハンドルは IDirectPlay8LobbyClient::ReleaseApplication メソッドの phApplication パラメータでも使用される。
dwTimeOut
接続の処理を待つ時間 (ミリ秒単位) を指定する DWORD 型の変数。
dwFlags
予約済み。0 に設定しておく。

戻り値

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

DPNERR_CANTLAUNCHAPPLICATION
DPNERR_INVALIDFLAGS
DPNERR_INVALIDPARAM
DPNERR_TIMEDOUT

動作環境

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