共用方式為

IEnumProgressItems：：RemoteNext 方法

  • 發行項

支援想要擷取列舉序列中指定專案數目的遠端用戶端

語法

HRESULT RemoteNext(
  [in]  ULONG         celt,
  [out] IProgressItem **rgelt,
  [out] ULONG         *pceltFetched
);

參數

celt [in]

要擷取的專案數。

rgelt [out]

IProgressItem介面的陣列。 完成時，您必須釋放 rgelt 中的每個介面。

pceltFetched [out]

rgelt 中傳回的專案數。 如果celt為 Null，您可以將pceltFetched設定為Null。 否則，請先將 pceltFetched 的值初始化為 0，再呼叫這個方法。

傳回值

S_OK傳回成功傳回 (celt) 的要求專案數目，或 (pceltFetched) 傳回的專案數小於要求的專案數目。

其他成功代碼可能會因為實作而傳回。 下列錯誤碼通常會在作業失敗時傳回，但不代表唯一可能的錯誤值：

傳回碼 Description
E_POINTER
 指標無效。
值：0x80004003
E_OUTOFMEMORY
 無法配置所需的記憶體。
值：0x8007000E
E_INVALIDARG
 一或多個引數無效。
值：0x80070057
E_UNEXPECTED
 發生未預期的失敗。
值：0x8000FFFF

備註

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

規格需求

需求 值
最低支援的用戶端
 Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2003 [僅限桌面應用程式]
Idl
Imapi2fs.idl

另請參閱

IEnumProgressItems

IEnumProgressItems：：Next