Platform SDK: DirectX |
IDirectPlay4::SetGroupConnectionSettings メソッドは、このグループから起動されるセッションの接続設定を設定する。このメソッドは、ロビー セッションでのみ使用できる。
HRESULT SetGroupConnectionSettings( DWORD dwFlags, DPID idGroup, LPDPLCONNECTION lpConnection );
成功した場合は DP_OK を返す。失敗した場合は、次のエラー値のいずれかを返す。
DPERR_ACCESSDENIED |
DPERR_CONNECTIONLOST |
DPERR_INVALIDGROUP |
DPERR_INVALIDPARAMS |
DPERR_UNSUPPORTED |
DPLCONNECTION 構造体のメンバの中にデフォルト値 (NULL 以外または 0 以外) が既に設定されているものがあるかどうかを調べるには、SetGroupConnectionSettings を呼び出す前に IDirectPlay4::GetGroupConnectionSettings を呼び出す。デフォルト値が設定されている場合に、それらを変更しようとすると、エラーが返されることがある。
SetGroupConnectionSettingsにより DPLCONNECTION 構造体の lpAddress データ メンバや dwAddressSize データ メンバを設定する必要はない。DPLCONNECTION 構造体内の DPSESSIONDESC2 構造体の guidInstance メンバも指定する必要はない。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dplay.h で宣言。
インポート ライブラリ : dplayx.lib を使用。
DPLCONNECTION、IDirectPlayLobby3::RunApplication、IDirectPlay4::GetGroupConnectionSettings