DirectPlay8Peer.CreateGroup

Creates a group in the current session. A group is a logical collection of players.

When this method is called, DirectPlay calls each player's DirectPlay8Event.CreateGroup method to notify him or her of the new group.

CreateGroup(GroupInfo As DPN_GROUP_INFO, _
    lFlags As Long) As Long

Parts

GroupInfo

DPN_GROUP_INFO type that contains the group description.

lFlags

Flag that controls how this method is processed. The following flag can be set for this method.

DPNOP_SYNC

Causes the method to process synchronously.

Return Values

Returns the asynchronous handle for this operation. This is the handle that is used in lAsyncHandle parameter of the DirectPlay8Peer.CancelAsyncOperation method to cancel the request, if the request is processed asynchronously.

Error Codes

If the method fails, Err.Number can be set to the following value.

Remarks

Microsoft® DirectPlay® does not maintain hierarchical groups because they can easily be implemented with flat groups and expeditious use of the group data.