共用方式為


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

如果 pstrNameNULL,則會忽略它;否則,呼叫端必須確定此參數不會指向專案上的有效 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

限定符類別