QualifierSet_Next 函式
擷取透過呼叫 QualifierSet_BeginEnumeration 函式而開始之列舉中的下一個限定詞。
注意
此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。
語法
HRESULT QualifierSet_Next (
[in] int vFunc,
[in] IWbemQualifierSet* ptr,
[in] LONG lFlags,
[out] BSTR* pstrName,
[out] VARIANT* pVal,
[out] LONG* plFlavor
);
參數
vFunc [in] 此參數未使用。
ptr [in] IWbemQualifierSet 執行個體的指標。
lFlags [in] 保留。 此參數必須是 0。
pstrName [out] 限定詞的名稱。 如果是 null，則會忽略此參數；否則，pstrName 不應指向有效的 BSTR，不然的話，會發生記憶體流失。 如果不是 Null，函式一律會在傳回 WBEM_S_NO_ERROR 時配置新的 BSTR。
pVal [out] 成功時是限定詞的值。 如果函式失敗，則不會修改 pVal 所指向的 VARIANT。 如果此參數為 null，則會忽略參數。
plFlavor [out] 指標，指向接收限定詞標註的 LONG。 如果不需要標註資訊，這個參數可以是 null。
傳回值
此函式傳回的下列值定義於 WbemCli.h 標頭檔中，或者，您可以將其定義為程式碼中的常數：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_E_INVALID_PARAMETER |
0x80041008 | 參數無效。 |
WBEM_E_UNEXPECTED |
0x8004101d | 呼叫端未呼叫 QualifierSet_BeginEnumeration。 |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 記憶體不足，無法開始新列舉。 |
WBEM_S_NO_MORE_DATA |
0x40005 | 列舉中沒有其他限定詞。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
備註
此函式會包裝向 IWbemQualifierSet::Next 方法發出的呼叫。
您可以重複呼叫 QualifierSet_Next 函式來列舉所有限定詞，直到函式傳回 WBEM_S_NO_MORE_DATA 為止。 若要提早終止列舉，請呼叫 QualifierSet_EndEnumeration 函式。
列舉期間傳回的限定詞順序未定義。
規格需求
平台：請參閱系統需求。
標頭：WMINet_Utils.idl
.NET Framework版本：自 4.7.2 起提供
