IDirectPlay3::AddGroupToGroup

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