(wbemcli.h) IWbemQualifierSet::GetNames 方法
IWbemQualifierSet::GetNames 方法會擷取目前對象或屬性中所有可用限定符的名稱。 或者,根據 IFlags 的篩選值,此方法會擷取特定限定符的名稱。
您可以使用每個名稱的 IWbemQualifierSet::Get ,依名稱存取這些限定符。 任何指定的物件都不能有零個限定符,因此傳回時 pstrNames 中的字串數目可以是0,即使 WBEM_S_NO_ERROR 傳回也一樣。
語法
HRESULT GetNames(
[in] long lFlags,
[out] SAFEARRAY **pNames
);
參數
[in] lFlags
下列其中一個常數。
0 (零)
傳回所有限定詞的名稱。
WBEM_FLAG_LOCAL_ONLY
只傳回目前屬性或物件特有的限定詞名稱。 如果目前的限定符集參考屬性,則只傳回屬性專屬的限定符, (包括覆寫) ,而不是從類別定義傳播的限定符。 如果目前的限定符集合參考實例,則只傳回實例特定的限定符名稱。 如果目前的限定符集合參考類別,則只傳回衍生類別的特定限定符。
WBEM_FLAG_PROPAGATED_ONLY
只傳回從另一個物件傳播的限定詞名稱。 例如,如果目前的限定符集參考屬性,則只會傳回從類別定義傳播至此屬性的限定符,而不是從屬性本身傳播到此屬性的限定符。 如果目前的限定符集參考實例,則只傳回從類別定義傳播的限定符。 如果目前的限定符集參考類別,則只傳回繼承自父類別的限定符名稱。
[out] pNames
系統會建立新的 SAFEARRAY ,其中包含要求的名稱。
在所有未傳回錯誤的情況下,都會建立新的數位,並將 pstrNames 設定為指向它。 即使產生的陣列有零個元素,也會發生這種情況。 發生錯誤時,不會傳回新的 SAFEARRAY 。
傳回值
這個方法會傳回 HRESULT ,指出方法呼叫的狀態。 下列清單列出 HRESULT 中包含的值。
備註
如需使用 BSTRS SAFEARRAY的範例,請參閱擷取 WMI 實例的一部分。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | wbemcli.h (包含 Wbemidl.h) |
程式庫 | Wbemuuid.lib |
Dll | Fastprox.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll |