Интерфейс IWbemObjectAccess (wbemcli.h)

Интерфейс IWbemObjectAccess предоставляет доступ к методам и свойствам объекта. Объект IWbemObjectAccess — это контейнер для экземпляра, обновляемого с помощью средства обновления. С помощью интерфейса IWbemObjectAccess можно получить и задать свойства с помощью дескрипторов свойств вместо имен свойств объектов.

Примечание Этот интерфейс ни при каких обстоятельствах не реализуется клиентскими приложениями или поставщиками. Реализация, предоставляемая WMI, является единственной, которая поддерживается. Указатель на интерфейс можно получить, вызвав IWbemClassObject::QueryInterface.

 

Наследование

Интерфейс IWbemObjectAccess наследуется от интерфейса IUnknown . IWbemObjectAccess также имеет следующие типы членов:

Методы

Интерфейс IWbemObjectAccess содержит следующие методы.

IWbemObjectAccess::GetPropertyHandle Метод GetPropertyHandle возвращает уникальный дескриптор, который идентифицирует свойство . Этот дескриптор можно использовать для идентификации свойств при использовании методов IWbemObjectAccess для чтения или записи значений свойств.
IWbemObjectAccess::GetPropertyInfoByHandle Метод GetPropertyInfoByHandle возвращает имя и тип данных свойства, связанного с дескриптором свойства.
IWbemObjectAccess::Lock Метод Lock предотвращает обновление объекта IWbemObjectAccess другими потоками до тех пор, пока он не будет разблокирован.
IWbemObjectAccess::ReadDWORD Метод ReadDWORD считывает 32 бита данных свойства с помощью дескриптора свойства.
IWbemObjectAccess::ReadPropertyValue Метод ReadPropertyValue возвращает указанное количество байтов свойства, связанного с дескриптором свойства.
IWbemObjectAccess::ReadQWORD Метод ReadQWORD считывает 64 бита данных свойства, определяемых дескриптором свойства.
IWbemObjectAccess::Unlock Метод Unlock позволяет другим потокам обновлять значения свойств объекта IWbemObjectAccess.
IWbemObjectAccess::WriteDWORD Метод WriteDWORD записывает 32 бита данных в свойство, определенное дескриптором свойства.
IWbemObjectAccess::WritePropertyValue Метод WritePropertyValue записывает указанное количество байтов в свойство, определяемое дескриптором свойства. Используйте этот метод, чтобы задать строку и все другие данные, отличные от DWORD или не-QWORD.
IWbemObjectAccess::WriteQWORD Метод WriteQWORD записывает 64 бита данных в свойство с помощью дескриптора свойства.

Комментарии

Методы IWbemObjectAccess , которые считывают и записывают данные, выполняют очень небольшую проверку данных. Так как методы IWbemObjectAccess напрямую обращаются к свойствам, вы можете получить и задать свойства гораздо быстрее, чем с помощью стандартных методов доступа к объектам, таких как IWbemClassObject::Get и IWbemClassObject::P ut.

Примечание Для максимальной скорости IWbemObjectAccess не установлен флажок. Пользователь несет ответственность за правильность всех дескрипторов и правильность размера буферов записи. Операции чтения и записи не являются потокобезопасны по своей сути. Необходимо вызвать методы IWbemObjectAccess::Lock и IWbemObjectAccess::Unlock , чтобы предотвратить одновременный доступ к объектам IWbemObjectAccess в нескольких потоках.

 

Дескрипторы свойств одинаковы для всех экземпляров класса. Поэтому необходимо получить дескриптор только один раз.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemcli.h (включая Wbemidl.h)

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

Доступ к данным о производительности в C++

Доступ к предварительно установленным классам производительности WMI

COM API для WMI

IWbemRefresher