Clase CInstance (instance.h)

[La clase CInstance forma parte del marco del proveedor de WMI que ahora se considera en estado final y no habrá más desarrollo, mejoras o actualizaciones disponibles para problemas no relacionados con la seguridad que afecten a estas bibliotecas. Las API de MI se deben usar para todo el nuevo desarrollo.]

La clase CInstance se usa para recuperar y actualizar los valores de las propiedades definidas para las instancias admitidas por el marco de proveedor de WMI. La clase CInstance también proporciona acceso a la implementación del marco de proveedor de la interfaz de CInstance .

No se espera que los escritores de proveedores deba derivar de esta clase. Use Provider::CreateNewInstance para crear una instancia de esta clase.

CInstance tiene estos tipos de miembros:

Método	Descripción
Confirmar	Devuelve la instancia actual a WMI.
Getbool	Recupera una propiedad booleana.
GetByte	Recupera una propiedad compatible con BYTE.
GetCHString	Recupera una propiedad de cadena.
GetClassObjectInterface	Devuelve un puntero de interfaz IWbemClassObject .
GetDateTime	Devuelve una propiedad datetime.
GetDOUBLE	Recupera una propiedad DOUBLE .
GetDWORD	Recupera una propiedad DWORD .
GetEmbeddedObject	Recupera una propiedad CInstance incrustada.
GetMethodContext	Devuelve un puntero a un objeto MethodContext .
GetStatus	Determina si existe una propiedad y, si es así, determina su tipo.
GetStringArray	Recupera una propiedad que representa una matriz de cadenas.
GetTimeSpan	Recupera una propiedad que representa un intervalo de tiempo de WMI.
GetVariant	Recupera una propiedad VARIANT .
GetWBEMINT16	Recupera una propiedad de entero de 16 bits.
GetWBEMINT64	Sobrecargado. Recupera una propiedad de entero de 64 bits.
GetWCHAR	Recupera una propiedad WCHAR .
GetWORD	Recupera una propiedad WORD .
IsNull	Determina si el valor de una propiedad determinada es NULL.
Setbool	Establece una propiedad booleana .
SetByte	Establece una propiedad BYTE .
SetCharSplat	Sobrecargado. Establece una propiedad de cadena.
SetCHString	Sobrecargado. Establece una propiedad de cadena.
SetDateTime	Establece una propiedad datetime.
SetDOUBLE	Establece una propiedad DOUBLE .
SetDWORD	Establece una propiedad DWORD .
SetEmbeddedObject	Establece una propiedad CInstance incrustada.
SetNull	Establece una propiedad en NULL.
SetStringArray	Establece una propiedad que representa una matriz de cadenas.
SetTimeSpan	Establece una propiedad que representa un intervalo de tiempo.
SetVariant	Establece una propiedad VARIANT .
SetWBEMINT16	Establece una propiedad de entero de 16 bits.
SetWBEMINT64	Sobrecargado. Establece una propiedad de entero de 64 bits.
SetWCHARSplat	Establece una propiedad de cadena WCHAR .
SetWORD	Establece una propiedad WORD .

Métodos

La clase CInstance tiene estos métodos.

CInstance::Commit El método Commit devuelve la instancia actual a WMI.
CInstance::Getbool El método Getbool recupera una propiedad booleana.
CInstance::GetByte El método GetByte recupera una propiedad compatible con BYTE.
CInstance::GetCHString El método GetCHString recupera una propiedad de cadena.
CInstance::GetClassObjectInterface El método GetClassObjectInterface devuelve un puntero de interfaz IWbemClassObject.
CInstance::GetDateTime El método GetDateTime devuelve una propiedad datetime.
CInstance::GetDOUBLE El método GetDOUBLE recupera una propiedad DOUBLE.
CInstance::GetDWORD El método GetDWORD recupera una propiedad DWORD.
CInstance::GetEmbeddedObject El método GetEmbeddedObject recupera un puntero a un objeto CInstance incrustado. El puntero se puede usar para obtener y establecer propiedades de ese objeto incrustado.
CInstance::GetMethodContext El método GetMethodContext devuelve un puntero a un objeto MethodContext.
CInstance::GetStatus El método GetStatus determina si existe una propiedad y, si es así, determina su tipo.
CInstance::GetStringArray El método GetStringArray recupera una propiedad que representa una matriz de cadenas.
CInstance::GetTimeSpan El método GetTimeSpan recupera una propiedad que representa un intervalo de tiempo de WMI.
CInstance::GetVariant El método GetVariant recupera una propiedad VARIANT.
CInstance::GetWBEMINT16 El método GetWBEMINT16 recupera una propiedad entera de 16 bits.
CInstance::GetWBEMINT64 El método GetWBEMINT64 recupera una propiedad entera de 64 bits. (sobrecarga 1/3)
CInstance::GetWBEMINT64 El método GetWBEMINT64 recupera una propiedad entera de 64 bits. (sobrecarga 3/3)
CInstance::GetWBEMINT64 El método GetWBEMINT64 recupera una propiedad entera de 64 bits. (sobrecarga 2/3)
CInstance::GetWCHAR El método GetWCHAR recupera una propiedad de cadena WCHAR.
CInstance::GetWORD El método GetWORD recupera una propiedad WORD.
CInstance::IsNull El método IsNull determina si el valor de una propiedad determinada es NULL.
CInstance::Setbool El método Setbool establece una propiedad booleana.
CInstance::SetByte El método SetByte establece una propiedad BYTE.
CInstance::SetCharSplat El método SetCharSplat(LPCWSTR, DWORD) establece una cadena.
CInstance::SetCharSplat El método SetCharSplat(LPCWSTR, LPCSTR) establece una propiedad de cadena.
CInstance::SetCharSplat El método SetCharSplat(LPCWSTR, LPCWSTR) establece una propiedad de cadena.
CInstance::SetCHString El método SetCHString(LPCWSTR, const CHString&) establece una propiedad de cadena. (sobrecarga 2/2)
CInstance::SetCHString El método SetCHString(LPCWSTR, LPCSTR) establece una propiedad de cadena.
CInstance::SetCHString El método SetCHString(LPCWSTR, const CHString&) establece una propiedad de cadena. (sobrecarga 1/2)
CInstance::SetDateTime El método SetDateTime establece una propiedad datetime.
CInstance::SetDOUBLE CInstance::SetDOUBLE (método)
CInstance::SetDWORD El método SetDWORD establece una propiedad DWORD.
CInstance::SetEmbeddedObject El método SetEmbeddedObject establece una propiedad CInstance incrustada.
CInstance::SetNull El método SetNull establece una propiedad en NULL.
CInstance::SetStringArray El método SetStringArray establece una propiedad que representa una matriz de cadenas.
CInstance::SetTimeSpan El método SetTimeSpan establece una propiedad que representa un intervalo de tiempo.
CInstance::SetVariant El método SetVariant establece una propiedad VARIANT.
CInstance::SetWBEMINT16 El método SetWBEMINT16 establece una propiedad entera de 16 bits.
CInstance::SetWBEMINT64 El método SetWBEMINT64(LPCWSTR, const LONGLONG&) establece un valor entero de 64 bits. (sobrecarga 3/3)
CInstance::SetWBEMINT64 El método SetWBEMINT64(LPCWSTR, const LONGLONG&) establece un valor entero de 64 bits. (sobrecarga 1/3)
CInstance::SetWBEMINT64 El método SetWBEMINT64(LPCWSTR, const LONGLONG&) establece un valor entero de 64 bits. (sobrecarga 2/3)
CInstance::SetWCHARSplat El método SetWCHARSplat establece una propiedad de cadena.
CInstance::SetWORD El método SetWORD establece una propiedad WORD.

Comentarios

El destructor de esta clase es CInstance::~CInstance.

Los métodos de la clase CInstance se usan para recuperar y establecer valores de propiedad. Los tipos de datos de propiedad se definen mediante tipos de datos CIM que se pueden ver en un archivo .mof. Al consultar o establecer un valor de propiedad mediante métodos de CInstance , es necesario usar un método compatible con el tipo de datos CIM de la propiedad. En la tabla siguiente se enumeran los tipos de datos CIM y los métodos de obtención o establecimiento permitidos de CInstance para acceder a una propiedad de ese tipo de datos.

Tipo de datos CIM	Tipos de método Get/Set de CInstance
string	CHString VARIANT WCHAR CharSplat
sint8	VARIANT
uint8	BYTE
sint16	WBEMINT16 VARIANT
uint16	WORD DWORD VARIANT
sint32	WORD DWORD VARIANT
uint32	WORD DWORD VARIANT
sint64	CHString VARIANT WBEMINT64 WCHAR
uint64	CHString VARIANT WBEMINT64 WCHAR
real32	VARIANT
real64	CHString DOUBLE VARIANT
char16	VARIANT
DateTime	CHString DateTime VARIANT WCHAR

Requisitos

Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	instance.h (incluir FwCommon.h)