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