Platform SDK: DirectX |
DirectPlay4.CreateGroupInGroup メソッドは、既存のグループ内にグループを作成する。ほかのグループ内に作成されたグループが列挙されるのは、DirectPlay4.GetDPEnumGroupsInGroup メソッドを使用した場合だけである。このようにして作成されたグループを破棄するには、DirectPlay4.DestroyGroup メソッドを呼び出す。
object.CreateGroupInGroup(parentid As Long, friendlyName As String, formalName As String, flags As CONST_DPGROUPFLAGS) As Long
作成されたグループの DirectPlay ID を返す。
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DPERR_CANTADDPLAYER |
DPERR_CONNECTIONLOST |
DPERR_INVALIDFLAGS |
DPERR_INVALIDGROUP |
DPERR_INVALIDPARAMS |
グループを作成できなかった場合は、DPERR_CANTADDPLAYER を返す。親グループの ID が無効の場合は、DPERR_INVALIDGROUP を返す。
グループをクライアント/サーバー セッションで作成した場合、グループ通知メッセージは送信されない。グループは、コンピュータがクライアントであるか、ホストであるかに関係なく、そのグループを作成したコンピュータからしか認識することができない。
グループをピアツーピア セッションで作成した場合、CreateGroupInGroup は、DPSYS_CREATEPLAYERORGROUP システム メッセージを生成して、この変更をほかのプレーヤーに通知する。
最上位グループを破棄すると、そのグループに含まれるメンバもすべて破棄され、適切な破棄メッセージが送信される。