IEnumIDList：：Next 方法 (shobjidl_core.h)

  • 發行項

擷取列舉序列中的指定專案標識碼數目，並依擷取的項目數目將目前的位置往前移。

語法

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

參數

[in] celt

類型： ULONG

rgelt 參數所參考陣列中的元素數目。

[out] rgelt

類型： LPITEMIDLIST*

接收項目識別碼之 ITEMIDLIST 指標陣列之指標的位址。 實作必須使用 CoTaskMemAlloc 來配置這些專案標識碼。 呼叫的應用程式負責使用 CoTaskMemFree 釋放項目識別碼。

陣列中傳回 的 ITEMIDLIST 結構相對於所列舉的 IShellFolder 。

[out] pceltFetched

類型： ULONG*

值的指標，這個值會接收在 rgelt 中實際傳回之專案標識子的計數。 計數可以小於 celt 參數中指定的值。 只有在 celt = 1 時，這個參數才能在專案上為 NULL，因為在此情況下，方法只能擷取一個 (S_OK) 或零個 (S_FALSE) 專案。

傳回值

類型： HRESULT

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

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

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

備註

如果這個方法傳回元件物件模型 (COM) 錯誤碼， (由 FAILED 宏) 決定，則 rgelt 陣列中沒有任何專案在結束時有效。 如果這個方法傳回成功程式代碼 (，例如S_OK或S_FALSE) ，則pceltFetched參數所指向的ULONG會決定 rgelt 陣列中有多少專案在結束時有效。

區別在 celt> 1 的情況下很重要。 例如，如果您傳遞 celt=10，而且只有 3 個元素左邊，*pceltFetched 將會是 3，而且方法會傳回S_FALSE表示您已到達檔案結尾。 三個擷取的項目會儲存到 rgelt 中，而且有效。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包括 Shobjidl.h)
Dll Shell32.dll (4.0 版或更新版本)

另請參閱

IEnumIDList