Share via


IEnumVdsObject::Next 方法 (vds.h)

[從 Windows 8 和 Windows Server 2012 開始,Windows 記憶體管理 API 會取代虛擬磁碟服務 COM 介面。]

從目前點開始,傳回列舉中的指定物件數目。 如需詳細資訊,請參閱 使用列舉物件

語法

HRESULT Next(
  [in]  ULONG    celt,
  [out] IUnknown **ppObjectArray,
  [out] ULONG    *pcFetched
);

參數

[in] celt

要傳回的物件數目。

[out] ppObjectArray

IUnknown 指標數位列的位址,VDS 會在傳回時初始化。

[out] pcFetched

ULONG 的位址,VDS 會在傳回 ppObjectArray 中的物件數目時初始化。

傳回值

這個方法可以傳回標準 HRESULT 值,例如E_INVALIDARG或E_OUTOFMEMORY,以及 VDS 特定的傳回值。 它也可以使用 HRESULT_FROM_WIN32 宏傳回已轉換的系統錯誤碼。 錯誤可能源自 VDS 本身,或來自正在使用的基礎 VDS 提供者 。 可能的傳回值包括下列專案。

傳回碼 描述
S_OK
方法傳回指定的物件數目。 pcFetched 中回報的傳回物件數目等於 celt;會傳回這些物件。
S_FALSE
指定的傳回物件數目大於剩餘的物件數目。 會傳回所有剩餘的物件,而且 在pcFetched 中報告傳回的物件數目小於 celt;會傳回這些物件。

備註

若要從 ppObjectArray 陣列中傳回的 IUnknown 指標取得物件特定的介面指標,請使用 IUnknown::QueryInterface 方法。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 vds.h
程式庫 Uuid.lib

另請參閱

IEnumVdsObject