Platform SDK: DirectX |
DirectPlay4.GetDPEnumGroupPlayers メソッドは、現在のオープン セッション内で特定のグループに属するプレーヤーを列挙する。
GetDPEnumGroupPlayers(GroupId As Long, _ sessionGuid As String, _ flags As CONST_DPENUMPLAYERFLAGS) _ As DirectPlayEnumPlayers
このフラグには、CONST_DPENUMPLAYERFLAGS 列挙型の以下の 1 つ以上の値を設定できる。
成功すれば、DirectPlayEnumPlayers オブジェクトを返す。
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DPERR_ACCESSDENIED |
DPERR_CONNECTIONLOST |
DPERR_INVALIDPARAMS |
DPERR_INVALIDGROUP |
DPERR_NOSESSIONS |
DPERR_UNAVAILABLE |
このメソッドは、セッションが、接続先ではないロビー セッションの場合は、DPERR_ACCESSDENIED を返す。sessionGuid またはフラグが無効な場合は、DPERR_INVALIDPARAMS を返す。アクティブなセッションが存在しない場合は、DPERR_NOSESSIONS を返す。セッションを列挙できなかった場合は、DPERR_UNAVAILABLE を返す。
パスワードで保護されたリモート セッションは列挙されない。接続していないロビー セッションでこのメソッドを使用することはできない。
このメソッドは、デフォルトでは、現在のセッション内のすべてのプレーヤーを列挙する。セッションのホストが列挙用のリストを提供するように要求するには、DPENUMPLAYERS_SESSION フラグと、セッション インスタンスの GUID を使用する。DPENUMPLAYERS_SESSION フラグをこのメソッドで使用するのは、DirectPlay4.GetDPEnumSessions メソッドを呼び出した後で、なおかつ DirectPlay4.Close メソッドまたは DirectPlay4.Open メソッドを呼び出す前でなければならない。
DirectPlay4.CreatePlayer、DirectPlay4.DestroyPlayer、DirectPlay4.AddPlayerToGroup、DirectPlay4.DeletePlayerFromGroup、GUID の使用