Share via


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
E_POINTER
指標無效。

值:0x80004003

E_OUTOFMEMORY
無法配置所需的記憶體。

值:0x8007000E

E_INVALIDARG
一或多個自變數無效。

值:0x80070057

備註

如果序列中剩餘的元素數目少於要求的元素數目,則會擷取其餘元素。

規格需求

需求
最低支援的用戶端 Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 imapi2fs.h

另請參閱

IEnumProgressItems

IEnumProgressItems::RemoteNext