共用方式為


(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