Interfaz IWbemObjectAccess (wbemcli.h)

La interfaz IWbemObjectAccess proporciona acceso a los métodos y propiedades de un objeto . Un objeto IWbemObjectAccess es un contenedor de una instancia actualizada por un actualizador. Con la interfaz IWbemObjectAccess , puede obtener y establecer propiedades mediante identificadores de propiedad en lugar de nombres de propiedad de objeto.

Nota Esta interfaz no se implementa mediante aplicaciones cliente ni proveedores en ninguna circunstancia. La implementación proporcionada por WMI es la única que se admite. Se puede recuperar un puntero a la interfaz llamando a IWbemClassObject::QueryInterface.

 

Herencia

La interfaz IWbemObjectAccess hereda de la interfaz IUnknown . IWbemObjectAccess también tiene estos tipos de miembros:

Métodos

La interfaz IWbemObjectAccess tiene estos métodos.

IWbemObjectAccess::GetPropertyHandle El método GetPropertyHandle devuelve un identificador único que identifica una propiedad. Puede usar este manipulador para identificar las propiedades al usar métodos IWbemObjectAccess para leer o escribir valores de propiedad.
IWbemObjectAccess::GetPropertyInfoByHandle El método GetPropertyInfoByHandle devuelve el nombre y el tipo de datos de la propiedad asociada a un identificador de propiedad.
IWbemObjectAccess::Lock El método Lock impide que otros subprocesos actualicen un objeto IWbemObjectAccess hasta que se desbloquee.
IWbemObjectAccess::ReadDWORD El método ReadDWORD lee 32 bits de datos de propiedad mediante un identificador de propiedad.
IWbemObjectAccess::ReadPropertyValue El método ReadPropertyValue devuelve un número especificado de bytes de una propiedad asociada a un identificador de propiedad.
IWbemObjectAccess::ReadQWORD El método ReadQWORD lee 64 bits de datos de propiedad identificados por un identificador de propiedad.
IWbemObjectAccess::Unlock El método Unlock permite que otros subprocesos actualicen los valores de propiedad de un objeto IWbemObjectAccess.
IWbemObjectAccess::WriteDWORD El método WriteDWORD escribe 32 bits de datos en una propiedad identificada por un identificador de propiedad.
IWbemObjectAccess::WritePropertyValue El método WritePropertyValue escribe un número especificado de bytes en una propiedad identificada por un identificador de propiedad. Utilice este método para establecer cadenas y todos los demás datos que no sean DWORD o que no sean QWORD.
IWbemObjectAccess::WriteQWORD El método WriteQWORD escribe 64 bits de datos en una propiedad mediante un identificador de propiedad.

Comentarios

Los métodos IWbemObjectAccess que leen y escriben datos realizan muy poca validación de datos. Dado que los métodos IWbemObjectAccess acceden directamente a las propiedades, puede obtener y establecer propiedades mucho más rápidamente de lo que puede usar técnicas de acceso a objetos estándar, como IWbemClassObject::Get e IWbemClassObject::P ut.

Nota Para maximizar su velocidad, IWbemObjectAccess está completamente desactivada. Es responsabilidad del usuario asegurarse de que todos los identificadores son adecuados y que los búferes de escritura tienen el tamaño correcto. Las operaciones de lectura y escritura no son intrínsecamente seguras para subprocesos. Debe llamar a los métodos IWbemObjectAccess::Lock e IWbemObjectAccess::Unlock para evitar que los objetos IWbemObjectAccess accedan simultáneamente en varios subprocesos.

 

Los identificadores de propiedad son los mismos para todas las instancias de una clase. Por lo tanto, solo es necesario recuperar un identificador una vez.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemcli.h (include Wbemidl.h)

Consulte también

Acceso a datos de rendimiento en C++

Acceso a clases de rendimiento preinstaladas de WMI

API COM para WMI

IWbemRefresher