Функция 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.
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по