(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

另請參閱

IWbemQualifierSet

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::Get