IEnumShellItems::Next 方法(shobjidl_core.h)

從枚舉中取得一個或多個 IShellItem 介面的陣列。

語法

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

Parameters

[in] celt

類型: ULONG

由 rgelt 參數參考的陣列元素數量。

[out] rgelt

類型: IShellItem**

一組指向接收列舉項目的 IShellItem 介面指標的位址。 呼叫應用程式負責透過呼叫 IUnknown::Release 方法來釋放 IShellItem 介面。

[out] pceltFetched

類型: 烏龍*

一個指標指向一個值,該值會接收成功取得的 IShellItem 介面數量。 計數可以小於 celt 參數中指定的值。 此參數只有在 celt 為 1 時才可在條目時為 NULL,因為此時方法只能檢索一個項目並回傳 S_OK,或是 0 項目且回傳 S_FALSE。

返回值

類型:HRESULT

這個方法可以傳回其中一個值。

回傳碼 Description
S_OK
若至少取得一個 IShellItem 介面。
S_FALSE
如果列舉中已無更多 IShellItem 介面。
如果函式因其他原因失敗,則會回傳錯誤值。

要求

需求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平臺 Windows 作業系統
標頭 shobjidl_core.h(包括 Shobjidl.h)

另請參閱

IEnumShellItems

IShell項目