Microsoft DirectX 8.0 (C++)

IDirectPlay8Peer::EnumGroupMembers

グループ内のすべてのプレーヤーの一覧を取得する。

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

パラメータ

dpnid
列挙するプレーヤーを保持するグループを指定する DPNID 型の変数。
prgdpnid
グループのプレーヤーの識別子を格納する配列へのポインタ。
pcdpnid
dpnid がポイントするバッファに格納できる識別子の数を指定する、DWORD 型の変数へのポインタ。バッファが小さすぎる場合、このメソッドは DPNERR_BUFFERTOOSMALL を返す。このパラメータには、必要なエントリの数が設定される。
dwFlags
予約済み。0 に設定しておく。

戻り値

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

DPNERR_BUFFERTOOSMALL
DPNERR_INVALIDFLAGS
DPNERR_INVALIDGROUP

注意

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

動作環境

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