IWbemClassObject：：Next 方法 (wbemcli.h)

發行項
08/27/2023

IWbemClassObject：：Next方法會在以IWbemClassObject：：BeginEnumeration開頭的列舉中擷取下一個屬性。這應該重複呼叫，以列舉所有屬性，直到傳回 WBEM_S_NO_MORE_DATA 為止。如果要提早終止列舉，則應該呼叫 IWbemClassObject：：EndEnumeration 。

未定義列舉期間傳回的屬性順序。

語法

HRESULT Next(
  [in]            long    lFlags,
  [out]           BSTR    *strName,
  [out]           VARIANT *pVal,
  [out, optional] CIMTYPE *pType,
  [out, optional] long    *plFlavor
);

參數

[in] lFlags

保留的。此參數必須是 0。

[out] strName

接收包含屬性名稱的新 BSTR 。若要防止用戶端進程中的記憶體流失，呼叫端必須在不再需要名稱時呼叫 SysFreeString 。如果不需要名稱，您可以將此參數設定為 Null 。

[out] pVal

這個 VARIANT 會填入屬性的值。方法會在此VARIANT上呼叫VariantInit，因此呼叫端應該在呼叫之前確保VARIANT不在作用中。當不再需要值時，呼叫端必須使用 VariantClear 。

如果不需要此值，您可以將此參數設定為 Null 。如果傳回錯誤碼，pVal所指向的VARIANT會保持未修改。

[out, optional] pType

此參數可以是 Null。如果不是 Null，它必須指向 CIMTYPE 變數， (放置屬性類型的 LONG) 。此屬性的值可以是 VT_NullVARIANT，在此情況下，必須判斷屬性的實際類型。

[out, optional] plFlavor

可以是 Null。如果不是 Null，則指向 的 LONG 值會接收屬性來源的資訊，如下所示。如需詳細資訊，請參閱限定詞類別和 WBEM_FLAVOR_TYPE。

WBEM_FLAVOR_ORIGIN_SYSTEM

屬性是標準系統屬性。

針對類別：

WBEM_FLAVOR_ORIGIN_PROPAGATED

屬性繼承自父類別。

繼承自父類別的屬性尚未在實例層級修改。

WBEM_FLAVOR_ORIGIN_LOCAL

屬性屬於衍生最多類別。

屬性會在實例層級修改， (亦即已提供值或已新增/修改限定詞) 。

例如：

傳回值

這個方法會傳回 HRESULT ，指出方法呼叫的狀態。下列清單列出 HRESULT中包含的值。如需一般 HRESULT 值，請參閱系統錯誤碼。

備註

如果屬性的基礎類型是物件路徑、日期或時間或其他特殊類型，則傳回的類型不包含足夠的資訊。呼叫端必須檢查指定之屬性的 CIMTYPE ，並判斷屬性是否為物件參考、日期或時間或其他特殊類型。

這個方法也會傳回系統屬性。

規格需求


最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	wbemcli.h (包含 Wbemidl.h)
程式庫	WbemUuid.lib
Dll	CIMWin32.dll;Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll;Wbemess.dll;Wmipiprt.dll