Platform SDK: DirectX

IDirectPlay4::DestroyGroup

IDirectPlay4::DestroyGroup メソッドは、グループをセッションから削除する。このグループに属する ID は、カレント セッションでは再利用されない。

HRESULT DestroyGroup(
  DPID idGroup
);

パラメータ

idGroup
ゲームから削除されるグループの ID。

戻り値

処理が成功した場合は DP_OK を返す。失敗した場合は、次のエラー メッセージのいずれかを返す。

DPERR_CONNECTIONLOST
DPERR_INVALIDGROUP
DPERR_INVALIDOBJECT
DPERR_INVALIDPARAMS
DPERR_INVALIDPLAYER

注意

グループを削除する前に、そのグループを空にする必要はない。そのグループに属する個別のプレーヤーは、破棄されない。このメソッドは、グループのプレーヤーごとに DPMSG_DELETEPLAYERFROMGROUP システム メッセージを作成してから、DPMSG_DESTROYPLAYERORGROUP システム メッセージを作成する。システム メッセージのリストについては、「システム メッセージの使用」を参照すること。

アプリケーションでは、ローカルに作成されたグループでなくても、任意のグループを破棄できる。

必要条件

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

参照

IDirectPlay4::CreateGroupDPMSG_DESTROYPLAYERORGROUP