Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
[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 |
VARIANT WCHAR CharSplat |
| sint8 | VARIANT |
| uint8 | BYTE |
| sint16 |
WBEMINT16 VARIANT |
| uint16 |
WORD DWORD VARIANT |
| sint32 |
WORD DWORD VARIANT |
| uint32 |
WORD DWORD VARIANT |
| sint64 |
VARIANT WBEMINT64 WCHAR |
| uint64 |
VARIANT WBEMINT64 WCHAR |
| real32 | VARIANT |
| real64 |
DOUBLE VARIANT |
| char16 | VARIANT |
| DateTime |
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) |