(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 實例的一部分。

規格需求

另請參閱

IWbemQualifierSet

IWbemQualifierSet：：BeginEnumeration

IWbemQualifierSet：：Get