QualifierSet_BeginEnumeration 函式

將物件限定詞的列舉程式重設為列舉開始時的狀態。

注意

此 API 僅供內部使用。不是要讓您在開發人員程式碼中使用。

語法

HRESULT QualifierSet_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

vFunc
[in] 此參數未使用。

ptr
[in] IWbemQualifierSet 執行個體的指標。

lFlags
[in] 備註一節中所述旗標或值的位元組合，可控制列舉中包含的限定詞。

此函式傳回的下列值定義於 WbemCli.h 標頭檔中，或者，您可以將其定義為程式碼中的常數：

常數	值	描述
`WBEM_E_INVALID_PARAMETER`	0x80041008	`lFlags` 參數無效。
`WBEM_E_UNEXPECTED`	0x8004101d	在沒有介入呼叫 `QualifierSet_EndEnumeration` 下進行第二次呼叫 `QualifierSet_BeginEnumeration`。
`WBEM_E_OUT_OF_MEMORY`	0x80041006	記憶體不足，無法開始新列舉。
`WBEM_S_NO_ERROR`	0	函式呼叫成功。

此函式會包裝向 IWbemQualifierSet::EndEnumeration 方法發出的呼叫。

若要列舉物件上的所有限定詞，必須先呼叫這個方法，才能進行第一次對 QualifierSet_Next 的呼叫。列舉限定詞的順序保證為指定列舉的不變異。

可以當做 lEnumFlags 引數傳遞的旗標，會於 WbemCli.h 標頭檔中定義，或者可以將它們定義為程式碼中的常數。

常數	值	描述
	0	傳回所有限定詞的名稱。
`WBEM_FLAG_LOCAL_ONLY`	0x10	只傳回目前屬性或物件特有的限定詞名稱。針對屬性：只傳回屬性特定的限定詞 (包括覆寫)，而非從類別定義傳播的限定詞。針對執行個體：只傳回執行個體特定的限定詞名稱。針對類別：只傳回衍生類別的特定限定詞。
`WBEM_FLAG_PROPAGATED_ONLY`	0x20	只傳回從另一個物件傳播的限定詞名稱。針對屬性：只傳回從類別定義傳播至此屬性的限定詞，而非從屬性本身傳播的限定詞。針對執行個體：只傳回從類別定義傳播的限定詞。針對類別：只傳回繼承自父類別的限定詞名稱。

平台：請參閱系統需求。

標頭：WMINet_Utils.idl

.NET Framework版本：自 4.7.2 起提供