Метод IWbemQualifierSet::GetNames (wbemcli.h)

Статья
08/27/2023

Метод 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.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemcli.h (включая Wbemidl.h)
Библиотека	Wbemuuid.lib
DLL	Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll