Функция GetPropertyHandle

Возвращает уникальный маркер, определяющий свойство.

Примечание

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

Синтаксис

HRESULT GetPropertyHandle (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] LPCWSTR              wszPropertyName,
   [out] CIMTYPE*            pType,
   [out] long*               pHandle
);

Параметры

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

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

wszPropertyName
[in] Строка символов в кодировке UTF16, заканчивающаяся нулевым значением, которая содержит имя свойства.

pType
[out] Указатель на CIMTYPE элемент перечисления, представляющий тип CIM свойства.

pHandle
[out] Указатель на целое число, содержащее дескриптор свойства.

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

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

Константа Значение Описание
WBEM_E_NOT_FOUND 0x80041002 Указанное имя свойства не найдено.
WBEM_E_INVALID_PARAMETER 0x80041008 Недействительный параметр.
WBEM_E_NOT_SUPPORTED 0x8004100c Запрошенное свойство имеет тип или CIM_OBJECTCIM_ARRAY.
WBEM_S_NO_ERROR 0 Вызов функции выполнен успешно.

Комментарии

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

Этот дескриптор можно использовать для идентификации свойств при использовании методов IWbemObjectAccess для чтения или записи значений свойств.

Дескрипторы можно получить для свойств всех типов данных, кроме CIM_OBJECT и CIM_ARRAY. Возвращенные дескрипторы работают во всех экземплярах класса.

Требования

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

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

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

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

  • Last updated on