Platform SDK: DirectX

IDirectPlay4::GetGroupConnectionSettings

IDirectPlay4::GetGroupConnectionSettings メソッドは、DPLCONNECTION 構造体からグループの接続設定を取得する。このグループから起動されたセッションはすべて、これらの設定値を使用する。このメソッドは、ロビー セッションでのみ使用できる。

HRESULT GetGroupConnectionSettings(
  DWORD dwFlags,
  DPID idGroup,
  LPVOID lpData,
  LPDWORD lpdwDataSize
);

パラメータ

dwFlags
使用しない。0 に設定しておく。
idGroup
接続設定を取得するグループの ID。
lpData
DPLCONNECTION 構造体とその全データをコピーするバッファへのポインタ。データのサイズのみを要求する場合は、このパラメータに NULL を設定する。lpdwDataSize パラメータには、データを保持するために必要な最低サイズを設定する。
lpdwDataSize
このメソッドを呼び出す前に、バッファのサイズに初期化された変数へのポインタ。メソッドが戻ると、このパラメータにはデータのサイズがバイト単位で設定されている。バッファが小さすぎる場合 (DPERR_BUFFERTOOSMALL)、このパラメータには最低限必要なバッファのサイズが設定される。

戻り値

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

DPERR_ACCESSDENIED
DPERR_BUFFERTOOSMALL
DPERR_INVALIDGROUP
DPERR_INVALIDFLAGS
DPERR_INVALIDPARAMS
DPERR_UNSUPPORTED

注意

グループの接続設定は、ステージング領域のグループにのみ関係がある。

DPSESSIONDESC2 構造体の guidInstance データ メンバを参照すると、ゲームが起動されているかどうかを調べることができる。この構造体のポインタは、このメソッドで返される DPLCONNECTION 構造体の lpSessionDesc データ メンバに格納されている。guidInstance は、ゲームが起動されるまでは GUID_NULL である。

必要条件

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

参照

DPLCONNECTIONIDirectPlayLobby3::RunApplicationIDirectPlay4::SetGroupConnectionSettings