Platform SDK: DirectX |
IDirectPlay4::GetGroupConnectionSettings メソッドは、DPLCONNECTION 構造体からグループの接続設定を取得する。このグループから起動されたセッションはすべて、これらの設定値を使用する。このメソッドは、ロビー セッションでのみ使用できる。
HRESULT GetGroupConnectionSettings( DWORD dwFlags, DPID idGroup, LPVOID lpData, LPDWORD lpdwDataSize );
成功した場合は 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 を使用。
DPLCONNECTION、IDirectPlayLobby3::RunApplication、IDirectPlay4::SetGroupConnectionSettings