Функция QualifierSet_GetNames

Извлекает имена всех квалификаторов или определенных квалификаторов, доступных из текущего объекта или свойства.

Примечание

Этот интерфейс API предназначен только для внутреннего использования. Он не предназначен для использования из кода разработчика.

Синтаксис

HRESULT QualifierSet_GetNames (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] SAFEARRAY (BSTR)**  pstrNames
);

Параметры

vFunc
[in] Этот параметр не используется.

ptr
[in] Указатель на экземпляр IWbemQualifierSet .

lFlags
[in] Один из следующих флагов или значений, указывающих, какие имена следует включить в перечисление.

Константа Значение Описание
0 Возвращает имена всех квалификаторов.
WBEM_FLAG_LOCAL_ONLY 0x10 Возвращает только имена квалификаторов, относящиеся к текущему свойству или объекту .
Для свойства: возвращает только квалификаторы, относящиеся к свойству (включая переопределения), а не квалификаторы, распространяемые из определения класса.
Для экземпляра: возвращает только имена квалификатора для конкретного экземпляра.
Для класса: возвращает только квалификаторы, относящиеся к производимому классу.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Возвращает только имена квалификаторов, распространяемых из другого объекта.
Для свойства: возвращает только квалификаторы, распространяемые на это свойство из определения класса, а не из самого свойства.
Для экземпляра: возвращает только те квалификаторы, которые распространяются из определения класса.
Для класса: возвращает только те имена квалификатора, которые наследуются от родительских классов.

pstrNames
[out] Новый SAFEARRAY объект , содержащий запрошенные имена. Массив может содержать 0 элементов. При возникновении ошибки новый SAFEARRAY объект не возвращается.

Возвращаемое значение

Следующие значения, возвращаемые этой функцией, определяются в файле заголовка WbemCli.h , или их можно определить как константы в коде:

Константа Значение Описание
WBEM_E_INVALID_PARAMETER 0x80041008 Недействительный параметр.
WBEM_E_OUT_OF_MEMORY 0x80041006 Недостаточно памяти для начала нового перечисления.
WBEM_S_NO_ERROR 0 Вызов функции выполнен успешно.

Комментарии

Эта функция заключает в оболочку вызов метода IWbemQualifierSet::GetNames .

После получения имен квалификатора можно получить доступ к каждому квалификатору по имени, вызвав функцию QualifierSet_Get .

Наличие нулевых квалификаторов для данного объекта не является ошибкой, поэтому количество строк в pstrNames при возврате может быть равно 0, даже если функция возвращает WBEM_S_NO_ERRORзначение .

Требования

Платформы: см. раздел Требования к системе.

Заголовка: WMINet_Utils.idl

версии платформа .NET Framework: доступно с версии 4.7.2.

См. также раздел

  • Last updated on