IDirectPlay2::DestroyGroup

HRESULT DestroyGroup(DPID idGroup);

Deletes a group from the session. The ID belonging to this group will not be reused during the current session.

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

DPERR_INVALIDOBJECT

DPERR_INVALIDPARAMS

DPERR_INVALIDPLAYER

idGroup

The ID of the group being removed from the game.

It is not necessary to empty a group before deleting it. The individual players belonging to the group are not destroyed. This method will generate a DPSYS_DELETEPLAYERFROMGROUP system message for each player in the group, and then a DPSYS_DESTROYPLAYERORGROUP system message. For a list of system messages, see Using System Messages.