WbebemQualifierSet::BeginEnumeration 方法 (wbemcli.h)
IWbemQualifierSet::BeginEnumeration 方法會在物件中的所有限定符列舉之前重設。 若要列舉物件上的所有限定符,必須在第一次呼叫 IWbemQualifierSet::Next 之前呼叫這個方法。 列舉限定符的順序保證為 IWbemQualifierSet 指定實例的不變異。
語法
HRESULT BeginEnumeration(
[in] long lFlags
);
參數
[in] lFlags
指定要包含在列舉中的限定符。 它必須是下列其中一個常數。
0 (零)
傳回所有限定詞的名稱。
WBEM_FLAG_LOCAL_ONLY
只傳回目前屬性或物件特有的限定詞名稱。 如果目前的限定符集參考屬性,則只傳回屬性專屬的限定符, (包括覆寫) ,而不是從類別定義傳播的限定符。 如果目前的限定符集合參考實例,則只傳回實例特定的限定符名稱。 如果目前的限定符集合參考類別,則只傳回衍生類別的特定限定符。
WBEM_FLAG_PROPAGATED_ONLY
只傳回從另一個物件傳播的限定詞名稱。 例如,如果目前的限定符集參考屬性,則只會傳回從類別定義傳播至此屬性的限定符,而不是從屬性本身傳播到此屬性的限定符。 如果目前的限定符集參考實例,則只會傳回從類別定義傳播的限定符。 如果目前的限定符集參考類別,則只會傳回繼承自父類別的限定符名稱。
傳回值
這個方法會傳回 HRESULT ,指出方法呼叫的狀態。 下列清單列出 HRESULT 中包含的值。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | wbemcli.h (包含 Wbemidl.h) |
程式庫 | Wbemuuid.lib |
Dll | Fastprox.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll |