從枚舉中取得一個或多個 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 |
|---|---|
|
若至少取得一個 IShellItem 介面。 |
|
如果列舉中已無更多 IShellItem 介面。 |
| 如果函式因其他原因失敗,則會回傳錯誤值。 |
要求
| 需求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平臺 | Windows 作業系統 |
| 標頭 | shobjidl_core.h(包括 Shobjidl.h) |