勇芳软件工作室.汉化:  Windows Management Instrumentation > COM API for WMI > Interfaces >

IWbemObjectAccess

Previous pageReturn to chapter overviewNext page

IWbemObjectAccess界面提供对对象的方法和属性的访问。IWbemObjectAccess对象是由复习器更新的实例的容器。使用IWbemObjectAccess界面,您可以通过使用属性句柄而不是对象属性名称来获取和设置属性。

 

注意在任何情况下,此接口不由客户端应用程序或提供程序实现。WMI提供的实现是唯一被支持的实现。可以通过调用IWbemClassObject.QueryInterface来检索指向该接口的指针。

 

方法

 

IWbemObjectAccess接口继承了IWbemClassObject接口的方法。

 

此外,IWbemObjectAccess定义了以下方法。

 

方法

描述

GetPropertyHandle

返回识别属性的唯一句柄。使用IWbemObjectAccess方法读取或写入属性值时,可以使用此句柄来标识属性。

GetPropertyInfoByHandle

返回与属性句柄关联的属性的名称和数据类型。

防止其他进程更新IWbemObjectAccess对象,直到其解锁。

ReadDWORD

读取32位属性数据。

ReadPropertyValue

读取指定数量的字节的属性数据。

ReadQWORD

读取64位的属性数据。

开锁

允许其他进程更新IWbemObjectAccess对象的属性值。

WriteDWORD

写入32位的属性数据。

WritePropertyValue

写入指定数量的字节的属性数据。

WriteQWORD

写入64位的属性数据。

 

备注

 

读取和写入数据的IWbemObjectAccess方法执行很少的数据验证。由于IWbemObjectAccess方法直接访问属性,您可以比使用诸如IWbemClassObject.GetIWbemClassObject.Put之类的标准对象访问技术更快速地获取和设置属性。

 

注意为了最大限度地提高速度,IWbemObjectAccess完全未选中。用户有责任确保所有句柄都正确,写入缓冲区大小正确。读写操作本身不是线程安全的。您应该调用IWbemObjectAccess.LockIWbemObjectAccess.Unlock方法以防止IWbemObjectAccess对象在多个线程上并发访问。

 

属性句柄对于类的所有实例都是相同的。因此,只需要一次检索句柄。

 

要求

 

客户

需要Windows Vista,Windows XP,Windows 2000 Professional,Windows NT Workstation 4.0 SP4及更高版本,Windows Me,Windows 98或Windows 95。

服务器

需要Windows Server 2008,Windows Server 2003,Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。

在Wbemcli.inc中声明。

DLL

需要Esscli.dll。

需要Fastprox.dll。

需要Wbemess.dll。