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::LockIWbemObjectAccess::Unlock 方法,以防止 IWbemObjectAccess 对象在多个线程上并发访问。
 
对于类的所有实例,属性句柄都是相同的。 因此,只需检索句柄一次。

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wbemcli.h (包括 Wbemidl.h)

另请参阅

在 C++ 中访问性能数据

访问 WMI 预安装的性能类

适用于 WMI 的 COM API

IWbemRefresher