IEnumFullIDList::Next メソッド (shobjidl_core.h)

指定した数のIDLIST_ABSOLUTE項目を取得します。

構文

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

パラメーター

[in] celt

種類: ULONG

rgelt パラメーターによって参照される配列内で参照される項目の数。

[out] rgelt

種類: PIDLIST_ABSOLUTE*

成功した場合、 には PIDL 配列が含まれます。 実装では、 CoTaskMemAlloc を使用してこれらの項目識別子を割り当てる必要があります。 呼び出し元のアプリケーションは、 CoTaskMemFree を使用して項目識別子を解放する役割を担います。

[out] pceltFetched

種類: ULONG*

成功した場合、 には、 rgelt で実際に返される絶対項目識別子の数を受け取る値へのポインターが含まれます。 count は、 celt パラメーターで指定された値よりも小さくできます。 このパラメーターは、celt が 1 の場合にのみ NULL にすることができます。その場合、メソッドは 1 つ (S_OK) または 0 (S_FALSE) 項目のみを取得できるためです。

戻り値

種類: HRESULT

メソッドが要求された celt 要素を正常に取得した場合は、S_OKを返します。 このメソッドは、要求されたアイテムの完全な数が正常に取得された場合にのみ、S_OKを返します。

S_FALSEは、列挙に残っているアイテムよりも多くの項目が要求されたことを示します。 pceltFetched パラメーターによって指される値は、取得された項目の実際の数を指定します。 取得する項目がこれ以上ない場合、値は 0 になります。

それ以外の場合は、COM 定義のエラー値を返します。

要件