IDirectPlay2::SetGroupName

HRESULT SetGroupName(DPID idGroup,

LPDPNAME lpGroupName, DWORD dwFlags);

Sets the name of a group after it has been created. A DPSYS_SETPLAYERORGROUPNAME system message will be sent to all the other players notifying them of the change unless DPSESSION_NODATAMESSAGES is set in the session description. For a list of system messages, see Using System Messages.

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

DPERR_INVALIDOBJECT

DPERR_INVALIDPARAMS

DPERR_INVALIDPLAYER

idGroup

ID of the group for which the name is being set.

lpGroupName

Address of a DPNAME structure containing the name information for the group. Set this parameter to NULL if the group has no name information.

dwFlags

If this parameter is set to 0, the name will be propagated to all the remote systems by using nonguaranteed message passing.

DPSET_GUARANTEED

Propagates the data using guaranteed messaging (if available).