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 中實際傳回之絕對專案標識碼的計數。計數可以小於 celt 參數中指定的值。只有在 celt 為 1 時，這個參數才能在專案上為 NULL，因為在此情況下，方法只能擷取一個 (S_OK) 或零個 (S_FALSE) 專案。

類型： HRESULT

如果方法已成功擷取要求的 celt 元素，則傳回S_OK。如果成功擷取要求專案的完整計數，這個方法只會傳回S_OK。

S_FALSE表示要求的項目數目比列舉中還多。 pceltFetched 參數所指向的值會指定擷取的實際項目數目。請注意，如果沒有其他要擷取的專案，此值將會是 0。

否則會傳回 COM 定義的錯誤值。