Platform SDK: DirectX

IDirectPlay4::SetGroupConnectionSettings

IDirectPlay4::SetGroupConnectionSettings メソッドは、このグループから起動されるセッションの接続設定を設定する。このメソッドは、ロビー セッションでのみ使用できる。

HRESULT SetGroupConnectionSettings(
  DWORD dwFlags,
  DPID idGroup,
  LPDPLCONNECTION lpConnection
);

パラメータ

dwFlags
使用しない。0 に設定しておく。
idGroup
接続設定を設定するグループの ID。
lpConnection
起動するアプリケーション、使用するサービス プロバイダ、作成するセッションのセッション記述を記述した DPLCONNECTION 構造体へのポインタ。

戻り値

成功した場合は 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 を使用。

参照

DPLCONNECTIONIDirectPlayLobby3::RunApplicationIDirectPlay4::GetGroupConnectionSettings