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
标头	wbemcli.h (包括 Wbemidl.h)

另请参阅

在 C++ 中访问性能数据

访问 WMI 预安装的性能类

适用于 WMI 的 COM API

IWbemRefresher