Share via

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_Null的VARIANT。

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

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

傳回值

這個方法會傳回 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