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

Функция Get

Извлекает указанное значение свойства, если оно существует.

Примечание

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

Синтаксис

HRESULT Get (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Параметры

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

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

wszName
[in] Имя свойства.

lFlags
[in] Зарезервировано. Этот параметр должен иметь значение 0.

pVal
[out] Если функция возвращает успешно, содержит значение wszName свойства . Аргументу pval присваивается правильный тип и значение квалификатора.

pvtType
[out] Если функция возвращает успешно, содержит константу типа CIM , указывающую тип свойства. Его значение также может быть null.

plFlavor
[out] Если функция возвращается успешно, получает сведения о происхождении свойства. Его значение может быть nullравно или одной из следующих констант WBEM_FLAVOR_TYPE, определенных в файле заголовка WbemCli.h :

Константа Значение Описание
WBEM_FLAVOR_ORIGIN_SYSTEM 0x40 Свойство является стандартным системным свойством.
WBEM_FLAVOR_ORIGIN_PROPAGATED 0x20 Для класса: свойство наследуется от родительского класса.
Для экземпляра: свойство, унаследованное от родительского класса, не было изменено экземпляром .
WBEM_FLAVOR_ORIGIN_LOCAL 0 Для класса: свойство принадлежит производного класса.
Для экземпляра: свойство изменяется экземпляром ; т. е. было предоставлено значение или добавлен или изменен квалификатор.

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

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

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

Комментарии

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

Функция Get также может возвращать системные свойства.

Аргументу pVal присваивается правильный тип и значение для квалификатора и функции COM VariantInit .

Требования

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

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

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

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

  • Last updated on