Platform SDK: DirectX |
DirectPlay4.GetDPEnumGroups メソッドは、現在のセッション内の最上位グループをすべて列挙する。最上位グループは、DirectPlay4.CreateGroup メソッドを使用して作成されたグループである。
object.GetDPEnumGroups(sessionGuid As String, _ flags As CONST_DPENUMGROUPFLAGS) _ As DirectPlayEnumPlayers
このフラグには、CONST_DPENUMGROUPFLAGS 列挙型の以下のいずれかの値を設定できる。
成功すれば、DirectPlayEnumPlayers オブジェクトを返す。
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DPERR_CONNECTIONLOST |
DPERR_INVALIDPARAMS |
DPERR_NOSESSIONS |
DPERR_UNAVAILABLE |
このメソッドは、提供された sessionGuid またはフラグが無効な場合は、DPERR_INVALIDPARAMS を返す。開いたセッションが存在しない場合は、DPERR_NOSESSIONS を返す。リモート セッションを列挙できなかった場合は、DPERR_UNAVAILABLE を返す。
接続していないロビー セッションで、GetDPEnumGroups を使用することはできない。
開いたセッションが存在しない場合は、DPENUMGROUPS_SESSION フラグを指定し、セッションの sessionGuid を指定することにより、リモート セッションのグループを列挙することができる。パスワードで保護されたリモート セッションを列挙することはできない。
グループ内のサブグループを列挙するには、DirectPlay4.GetDPEnumGroupsInGroup を使用する。
DirectPlay4.DestroyGroup、DirectPlay4.GetDPEnumSessions、GUID の使用