Platform SDK: DirectX

IDirectPlay4::AddGroupToGroup

IDirectPlay4::AddGroupToGroup メソッドは、あるグループへのショートカットを既存のグループに追加する。これにより、リンクしたグループを IDirectPlay4::EnumGroupsInGroup メソッドで列挙することが可能になる。グループのショートカットを別のグループから削除するには、DeleteGroupFromGroup を呼び出す。

HRESULT AddGroupToGroup(
  DPID idParentGroup,
  DPID idGroup
);

パラメータ

idParentGroup
ショートカットの追加先グループのグループ ID。有効な任意のグループ ID を指定可能。
idGroup
ショートカットを追加するグループのグループ ID。有効な任意のグループ ID を指定可能。

戻り値

成功した場合は DP_OK を返す。失敗した場合は、次のエラー値のいずれかを返す。

DPERR_ACCESSDENIED
DPERR_CONNECTIONLOST
DPERR_INVALIDGROUP

注意

このメソッドを使用して、あるグループを複数のグループ「内」に配置できる。

この変更をプレーヤーに知らせるために、DPMSG_ADDGROUPTOGROUP システム メッセージが生成される。

必要条件

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

参照

IDirectPlay4::CreateGroupInGroupIDirectPlay4::DeleteGroupFromGroupIDirectPlay4::EnumGroupsInGroupDPMSG_ADDGROUPTOGROUP