Platform SDK: DirectX |
IDirectPlay4::DestroyGroup メソッドは、グループをセッションから削除する。このグループに属する ID は、カレント セッションでは再利用されない。
HRESULT DestroyGroup( DPID idGroup );
処理が成功した場合は 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 を使用。