Platform SDK: DirectX

IDirectPlayLobby3::GetConnectionSettings

IDirectPlayLobby3::GetConnectionSettings メソッドは、アプリケーションを起動して接続するために必要なすべての情報が格納された DPLCONNECTION 構造体を取得する。返されたデータは、ロビー クライアントにより IDirectPlayLobby3::RunApplication メソッドへ渡されたデータや、IDirectPlayLobby3::SetConnectionSettings メソッドを呼び出して設定されたデータと同じである。

HRESULT GetConnectionSettings(
  DWORD dwAppID,
  LPVOID lpData,
  LPDWORD lpdwDataSize
);

パラメータ

dwAppID
(複数のアプリケーションと通信する) ロビー クライアントから呼び出したときに取得するアプリケーションの接続設定を指定する。(1 つのロビー クライアントとのみ通信する) アプリケーションから呼び出すときは、このパラメータは 0 でなければならない。この ID 番号は、IDirectPlayLobby3::RunApplication から取得する。
lpData
接続設定を書き込むバッファへのポインタ。データのサイズのみを要求するときは、このパラメータに NULL を設定する。lpdwDataSize パラメータはデータを保持するのに最低限必要なサイズに設定される。
lpdwDataSize
このメソッドを呼び出す前に、バッファのサイズに初期化された変数へのポインタ。メソッドが戻ると、このパラメータにはデータのサイズがバイト単位で設定されている。バッファが小さすぎる (DPERR_BUFFERTOOSMALL) 場合、このパラメータには最低限必要なバッファのサイズが設定される。

戻り値

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

DPERR_BUFFERTOOSMALL
DPERR_GENERIC
DPERR_INVALIDINTERFACE
DPERR_INVALIDOBJECT
DPERR_INVALIDPARAMS
DPERR_NOTLOBBIED
DPERR_OUTOFMEMORY

注意

メソッドが戻ったら、lpData メンバを DPLCONNECTION 構造体にキャストし、データを読み取る必要がある。

必要条件

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : Dplobby.h で宣言。
  インポート ライブラリ : dplayx.lib を使用。

参照

DPLCONNECTIONIDirectPlayLobby3::RunApplicationIDirectPlayLobby3::SetConnectionSettingsIDirectPlayLobby3::WaitForConnectionSettings