IDirectPlay8Peer::EnumGroupMembers メソッド

IDirectPlay8Peer::EnumGroupMembers メソッド

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

構文

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

パラメータ

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

戻り値

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

DPNERR_BUFFERTOOSMALL	指定されたバッファが小さすぎて、要求されたデータを格納できない。
DPNERR_INVALIDFLAGS	このメソッドに渡されたフラグは無効である。
DPNERR_INVALIDGROUP	グループ ID が、このゲーム セッションに対する有効なグループ ID として認識されていない。

注意

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