Поделиться через


Функция GetPropertyQualifierSet

Получает набор квалификаторов для определенного свойства.

Примечание

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

Синтаксис

HRESULT GetPropertyQualifierSet (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszProperty,
   [out] IWbemQualifierSet  **ppQualSet
);

Параметры

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

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

wszMethod
[in] Имя свойства. wszProperty должен указывать на допустимый LPCWSTRобъект .

ppQualSet
[out] Получает указатель интерфейса, который разрешает доступ к квалификаторам свойства . Параметр ppQualSet не может иметь значение null. При возникновении ошибки новый объект не возвращается, а указатель указывает на null.

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

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

Константа Значение Описание
WBEM_E_FAILED 0x80041001 Произошел общий сбой.
WBEM_E_NOT_FOUND 0x80041002 Указанный метод не существует.
WBEM_E_OUT_OF_MEMORY 0x80041006 Недостаточно памяти для выполнения операции.
WBEM_E_INVALID_PARAMETER 0x80041008 Параметр имеет значение null.
WBEM_E_SYSTEM_PROPERTY 0x80041030 Функция пытается получить квалификаторы системного свойства.
WBEM_S_NO_ERROR 0 Вызов функции выполнен успешно.

Комментарии

Эта функция создает оболочку для вызова метода IWbemClassObject::GetPropertyQualifierSet .

Вызов этой функции поддерживается только в том случае, если текущий объект является определением класса CIM. Обработка методов недоступна для указателей IWbemClassObject , указывающих на экземпляры CIM.

Так как каждый метод может иметь собственные квалификаторы, указатель IWbemQualifierSet позволяет вызывающей объекту добавлять, изменять или удалять эти квалификаторы.

Так как системные свойства не имеют квалификаторов, функция возвращает значение WBEM_E_SYSTEM_PROPERTY при попытке получить указатель IWbemQualifierSet для системного свойства.

Требования

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

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

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

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