IEnumBackgroundCopyGroups::Next メソッド (qmgr.h)

[IEnumBackgroundCopyGroups は、[要件] セクションで指定されたオペレーティングシステムで使用できます。今後のバージョンでは変更されるか、利用できなくなる場合もあります。代わりに、 BITS インターフェイスを使用します。

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

構文

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

[in] celt

要求された要素の数。

[out] rgelt

グループを識別する GUID の配列。グループを取得するには、GUID を使用して IBackgroundCopyQMgr::GetGroup メソッドを呼び出します。

[out] pceltFetched

rgelt 内の要素の数。 celt が 1 の場合は、pceltFetchedを NULL に設定できます。

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

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