Microsoft DirectX 8.0 (C++)

IDirectPlay8Peer::EnumPlayersAndGroups

セッションのすべてのプレーヤーまたはグループの識別子、あるいはその両方の一覧を取得する。

HRESULT EnumPlayersAndGroups(
DPNID *const prgdpnid,
DWORD *const pcdpnid,
const DWORD dwFlags
);

パラメータ

prgdpnid
セッションのグループまたはプレーヤーの識別子、あるいはその両方がデータとして格納される配列へのポインタ。
pcdpnid
prgdpnid がポイントするバッファに格納できる識別子の数を指定する、DWORD 型の変数へのポインタ。バッファが小さすぎる場合、このメソッドは DPNERR_BUFFERTOOSMALL を返す。このパラメータには、必要なエントリの数が設定される。
dwFlags
列挙の動作を記述するフラグ。次の 1 つまたは両方のフラグを設定することができる。
DPNENUM_PLAYERS
プレーヤーの識別子のリストを返す。
DPNENUM_GROUPS
グループの識別子のリストを返す。

戻り値

成功した場合は S_OK を返し、失敗した場合は次のいずれかのエラー値を返す。

DPNERR_BUFFERTOOSMALL
DPNERR_INVALIDFLAGS

注意

グループおよびプレーヤーの情報は頻繁に変化するため、返される必要なバッファ サイズは以降の呼び出しで変わる場合がある。メソッドが成功するまで、バッファを確認し、再割り当てする。

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : Dplay8.h で宣言。