Share via

IWbemQualifierSet：：Next 方法 (wbemcli.h)

  • 發行項

IWbemQualifierSet：：Next 方法會在以 IWbemQualifierSet：：BeginEnumeration 開頭的列舉中擷取下一個限定符。 系統會重複呼叫這個方法，以列舉所有限定符，直到 傳回WBEM_S_NO_MORE_DATA 為止。 若要提早終止列舉，請呼叫 IWbemQualifierSet：：EndEnumeration。

未定義列舉期間傳回之限定符的順序。

語法

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

參數

[in] lFlags

保留的。 此參數必須是 0 (零) 。

[out] pstrName

此參數會接收限定符的名稱。 每當傳回WBEM_S_NO_ERROR時，一律會配置新的 BSTR。

如果 pstrName 為 NULL，則會忽略它;否則，呼叫端必須確定此參數不會指向專案上的有效 BSTR ，否則記憶體流失。 此外，當不再需要時，呼叫端必須記得在傳回的字串上呼叫 SysFreeString 。

[out] pVal

此參數會接收限定符的值。 這個方法會在 VARIANT 上呼叫 VariantInit。 當不再需要值時，呼叫端必須在此指標上呼叫 VariantClear 。 如果傳回錯誤碼，pVal 指向的 VARIANT 會保持未修改。 如果設定為 NULL，則會忽略此參數。

[out] plFlavor

如果不是 NULL，指向的值會設定為限定符類別。 如需詳細資訊，請參閱 限定符類別 和 WBEM_FLAVOR_TYPE。

傳回值

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

規格需求

需求 值
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 wbemcli.h (包含 Wbemidl.h)
程式庫 Wbemuuid.lib
Dll Fastprox.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll

另請參閱

IWbemQualifierSet：：BeginEnumeration

IWbemQualifierSet：：EndEnumeration

限定符類別