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) |