Compartir a través de


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)