IEnumBackgroundCopyFiles::Next メソッド (bits.h)

列挙体シーケンス内の指定した数の項目を取得します。シーケンスに残っている要素の数が要求された数より少ない場合は、残りの要素が取得されます。

構文

HRESULT Next(
  [in]  ULONG               celt,
  [out] IBackgroundCopyFile **rgelt,
  [out] ULONG               *pceltFetched
);

[in] celt

要求された要素の数。

[out] rgelt

IBackgroundCopyFile オブジェクトの配列。完了したら 、rgelt で各オブジェクトを解放する必要があります。

[out] pceltFetched

rgelt で返される要素の数。 celt が 1 の場合は、pceltFetched を NULL に設定できます。それ以外の場合は、このメソッドを呼び出す前に 、pceltFetched の値を 0 に初期化します。

このメソッドは、次の HRESULT 値と他の値を返します。

リターンコード	説明
S_OK	要求された要素の数が正常に返されました。
S_FALSE	要求された要素の数より小さい値が返されます。