Бөлісу құралы:

Функция 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