共用方式為


IWbemCoNtext::Next 方法 (wbemcli.h)

IWbemCoNtext::Next方法會擷取所有以IWbemCoNtext::BeginEnumeration開頭的內容值列舉中的下一個值。

語法

HRESULT Next(
  [in]  long    lFlags,
  [out] BSTR    *pstrName,
  [out] VARIANT *pValue
);

參數

[in] lFlags

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

[out] pstrName

此參數不可為 Null。 指標不得指向進入時的作用中 BSTR ,在理想情況下,它應該設定為指向 Null。 如果未傳回錯誤碼,則會將其設定為指向包含內容值名稱之新配置的 BSTR

當不再需要時,呼叫端必須在傳回的字串上呼叫 SysFreeString 。 如果 WBEM_S_NO_MORE_DATA 傳回, pstrName 會設定為指向 Null,在此情況下,不應該呼叫 SysFreeString 。 請注意,如果 pstrName 指向專案上的有效 BSTR ,則不會釋放此 BSTR ,而且會發生記憶體流失。

[out] pValue

此參數不可為 Null,而且必須指向空白或未初始化 的 VARIANT。 如果未傳回任何錯誤,則會使用 VariantInit初始化VARIANT,然後將 設定為包含內容值。 當不再需要值時,呼叫端必須在此指標上呼叫 VariantClear 。 如果傳回錯誤碼,pValue指向的VARIANT會保持未修改。

如果WBEM_S_NO_MORE_DATA傳回,此參數會設定為指向類型為 VT_NullVARIANT

整個 IWbemClassObject 物件可能會在 VARIANT內傳回。 如果是這種情況, 則VT_UNKNOWNVARIANT 類型。 呼叫端可以採用 IUnknown 指標並執行 QueryInterface 來取得 IWbemClassObject 指標。

注意 在列舉結束時, 會傳回WBEM_S_NO_MORE_DATA 。 傳回的 VARIANT 的類型 為 VT_Null,而傳回的 pstrNameNull
 

傳回值

這個方法會傳回 HRESULT ,指出方法呼叫的狀態。 下列清單列出 HRESULT中包含的值。

規格需求

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

另請參閱

IWbemCoNtext

IWbemCoNtext::BeginEnumeration

IWbemCoNtext::EndEnumeration