DirectPlay Animated Header -- IDirectPlay3::AddGroupToGroup DirectPlay Animated Header -- IDirectPlay3::AddGroupToGroup* Microsoft DirectPlay SDK
*Index  *Topic Contents
*Previous Topic: IDirectPlay3 Interface
*Next Topic: IDirectPlay3::AddPlayerToGroup


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

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

*Top of Page