##

IDirectPlay3::AddGroupToGroup

IDirectPlay3 Interface

Adds a shortcut to a group to an already existing group. This allows the linked group to be enumerated by the IDirectPlay3::EnumGroupsInGroup method. To remove a group's shortcut from another group, call DeleteGroupFromGroup.

HRESULT AddGroupToGroup(
DPID idParentGroup,
DPID idGroup
);

##### Parameters

idParentGroup
  ID of the group to which the shortcut will be added. Can be any valid group ID.
idGroup
  The group ID of the group whose shortcut will be added. Can be any valid group ID.

##### Return Values

Returns DP_OK if successful, or one of the following error values otherwise:

DPERR_ACCESSDENIED
DPERR_INVALIDGROUP

##### Remarks

This method can be used to place a group "inside" more than one group.

A DPMSG_ADDGROUPTOGROUP system message is generated to inform players of this change.

##### See Also

IDirectPlay3::CreateGroupInGroup, IDirectPlay3::DeleteGroupFromGroup, IDirectPlay3::EnumGroupsInGroup, DPMSG_ADDGROUPTOGROUP

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.