Platform SDK: DirectX |
IDirectPlay4::AddGroupToGroup メソッドは、あるグループへのショートカットを既存のグループに追加する。これにより、リンクしたグループを IDirectPlay4::EnumGroupsInGroup メソッドで列挙することが可能になる。グループのショートカットを別のグループから削除するには、DeleteGroupFromGroup を呼び出す。
HRESULT AddGroupToGroup( DPID idParentGroup, DPID idGroup );
成功した場合は 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::CreateGroupInGroup、IDirectPlay4::DeleteGroupFromGroup、IDirectPlay4::EnumGroupsInGroup、DPMSG_ADDGROUPTOGROUP