IEnumProgressItems::Next 方法 (imapi2fs.h)
擷取列舉型別序列中指定的項目數目。
語法
HRESULT Next(
[in] ULONG celt,
[out] IProgressItem **rgelt,
[out] ULONG *pceltFetched
);
參數
[in] celt
要擷取的項目數。
[out] rgelt
IProgressItem 介面的陣列。 完成時,您必須釋放 rgelt 中的每個介面。
[out] pceltFetched
rgelt 中傳回的項目數。 如果 celt 是 NULL,您可以將 pceltFetched 設定為 NULL。 否則,請先將 pceltFetched 的值初始化為0,再呼叫此方法。
傳回值
S_OK傳回要求的項目數目時, (celt) 成功傳回,或 (pceltFetched) 傳回的項目數小於要求的元素數目。
其他成功碼可能會因為實作而傳回。 下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:
傳回碼 | Description |
---|---|
|
指標無效。
值:0x80004003 |
|
無法配置所需的記憶體。
值:0x8007000E |
|
一或多個自變數無效。
值:0x80070057 |
備註
如果序列中剩餘的元素數目少於要求的元素數目,則會擷取其餘元素。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | imapi2fs.h |