Classe CInstance (instance.h)

[La classe CInstance fa parte del framework del provider WMI che è ora considerato nello stato finale e non saranno disponibili ulteriori aggiornamenti, miglioramenti o aggiornamenti per i problemi non correlati alla sicurezza che interessano queste librerie. Le API MI devono essere usate per tutti i nuovi sviluppi.

La classe CInstance viene usata per recuperare e aggiornare i valori delle proprietà definite per le istanze supportate da WMI Provider Framework. La classe CInstance fornisce anche l'accesso all'implementazione del framework del provider dell'interfaccia CInstance .

Non è previsto che i writer del provider dovranno derivare da questa classe. Usare Provider::CreateNewInstance per creare un'istanza di questa classe.

CInstance include questi tipi di membri:

Metodo	Descrizione
Eseguire il commit	Restituisce l'istanza corrente a WMI.
Getbool	Recupera una proprietà booleana.
GetByte	Recupera una proprietà compatibile con BYTE.
GetCHString	Recupera una proprietà stringa.
GetClassObjectInterface	Restituisce un puntatore dell'interfaccia IWbemClassObject .
GetDateTime	Restituisce una proprietà datetime.
Getdouble	Recupera una proprietà DOUBLE .
GetDWORD	Recupera una proprietà DWORD .
GetEmbeddedObject	Recupera una proprietà CInstance incorporata.
GetMethodContext	Restituisce un puntatore a un oggetto MethodContext .
GetStatus	Determina se esiste una proprietà e, in tal caso, determina il tipo.
GetStringArray	Recupera una proprietà che rappresenta una matrice di stringhe.
GetTimeSpan	Recupera una proprietà che rappresenta un intervallo di tempo WMI.
GetVariant	Recupera una proprietà VARIANT .
GetWBEMINT16	Recupera una proprietà integer a 16 bit.
GetWBEMINT64	Di overload. Recupera una proprietà integer a 64 bit.
GetWCHAR	Recupera una proprietà WCHAR .
GetWORD	Recupera una proprietà WORD .
IsNull	Determina se il valore di una determinata proprietà è NULL.
Setbool	Imposta una proprietà booleana .
SetByte	Imposta una proprietà BYTE .
SetCharSplat	Di overload. Imposta una proprietà stringa.
SetCHString	Di overload. Imposta una proprietà stringa.
SetDateTime	Imposta una proprietà datetime.
Setdouble	Imposta una proprietà DOUBLE .
SetDWORD	Imposta una proprietà DWORD .
SetEmbeddedObject	Imposta una proprietà CInstance incorporata.
SetNull	Imposta una proprietà su NULL.
SetStringArray	Imposta una proprietà che rappresenta una matrice di stringhe.
SetTimeSpan	Imposta una proprietà che rappresenta un intervallo di tempo.
SetVariant	Imposta una proprietà VARIANT .
SetWBEMINT16	Imposta una proprietà integer a 16 bit.
SetWBEMINT64	Di overload. Imposta una proprietà integer a 64 bit.
SetWCHARSplat	Imposta una proprietà stringa WCHAR .
SetWORD	Imposta una proprietà WORD .

Metodi

La classe CInstance include questi metodi.

CInstance::Commit Il metodo Commit restituisce l'istanza corrente a WMI.
CInstance::Getbool Il metodo Getbool recupera una proprietà booleana.
CInstance::GetByte Il metodo GetByte recupera una proprietà compatibile con BYTE.
CInstance::GetCHString Il metodo GetCHString recupera una proprietà stringa.
CInstance::GetClassObjectInterface Il metodo GetClassObjectInterface restituisce un puntatore dell'interfaccia IWbemClassObject.
CInstance::GetDateTime Il metodo GetDateTime restituisce una proprietà datetime.
CInstance::GetDOUBLE Il metodo GetDOUBLE recupera una proprietà DOUBLE.
CInstance::GetDWORD Il metodo GetDWORD recupera una proprietà DWORD.
CInstance::GetEmbeddedObject Il metodo GetEmbeddedObject recupera un puntatore a un oggetto CInstance incorporato. Il puntatore può essere utilizzato per ottenere e impostare le proprietà di tale oggetto incorporato.
CInstance::GetMethodContext Il metodo GetMethodContext restituisce un puntatore a un oggetto MethodContext.
CInstance::GetStatus Il metodo GetStatus determina se esiste una proprietà e, in tal caso, determina il tipo.
CInstance::GetStringArray Il metodo GetStringArray recupera una proprietà che rappresenta una matrice di stringhe.
CInstance::GetTimeSpan Il metodo GetTimeSpan recupera una proprietà che rappresenta un intervallo di tempo WMI.
CInstance::GetVariant Il metodo GetVariant recupera una proprietà VARIANT.
CInstance::GetWBEMINT16 Il metodo GetWBEMINT16 recupera una proprietà integer a 16 bit.
CInstance::GetWBEMINT64 Il metodo GetWBEMINT64 recupera una proprietà integer a 64 bit. (overload 1/3)
CInstance::GetWBEMINT64 Il metodo GetWBEMINT64 recupera una proprietà integer a 64 bit. (overload 3/3)
CInstance::GetWBEMINT64 Il metodo GetWBEMINT64 recupera una proprietà integer a 64 bit. (overload 2/3)
CInstance::GetWCHAR Il metodo GetWCHAR recupera una proprietà stringa WCHAR.
CInstance::GetWORD Il metodo GetWORD recupera una proprietà WORD.
CInstance::IsNull Il metodo IsNull determina se il valore di una determinata proprietà è NULL.
CInstance::Setbool Il metodo Setbool imposta una proprietà booleana.
CInstance::SetByte Il metodo SetByte imposta una proprietà BYTE.
CInstance::SetCharSplat Il metodo SetCharSplat(LPCWSTR, DWORD) imposta una stringa.
CInstance::SetCharSplat Il metodo SetCharSplat(LPCWSTR, LPCSTR) imposta una proprietà stringa.
CInstance::SetCharSplat Il metodo SetCharSplat(LPCWSTR, LPCWSTR) imposta una proprietà stringa.
CInstance::SetCHString Il metodo SetCHString(LPCWSTR, const CHString&) imposta una proprietà stringa. (overload 2/2)
CInstance::SetCHString Il metodo SetCHString(LPCWSTR, LPCSTR) imposta una proprietà stringa.
CInstance::SetCHString Il metodo SetCHString(LPCWSTR, const CHString&) imposta una proprietà stringa. (overload 1/2)
CInstance::SetDateTime Il metodo SetDateTime imposta una proprietà datetime.
CInstance::SetDOUBLE Metodo CInstance::SetDOUBLE
CInstance::SetDWORD Il metodo SetDWORD imposta una proprietà DWORD.
CInstance::SetEmbeddedObject Il metodo SetEmbeddedObject imposta una proprietà CInstance incorporata.
CInstance::SetNull Il metodo SetNull imposta una proprietà su NULL.
CInstance::SetStringArray Il metodo SetStringArray imposta una proprietà che rappresenta una matrice di stringhe.
CInstance::SetTimeSpan Il metodo SetTimeSpan imposta una proprietà che rappresenta un intervallo di tempo.
CInstance::SetVariant Il metodo SetVariant imposta una proprietà VARIANT.
CInstance::SetWBEMINT16 Il metodo SetWBEMINT16 imposta una proprietà integer a 16 bit.
CInstance::SetWBEMINT64 Il metodo SetWBEMINT64(LPCWSTR, const LONGLONG&) imposta un valore intero a 64 bit. (overload 3/3)
CInstance::SetWBEMINT64 Il metodo SetWBEMINT64(LPCWSTR, const LONGLONG&) imposta un valore intero a 64 bit. (overload 1/3)
CInstance::SetWBEMINT64 Il metodo SetWBEMINT64(LPCWSTR, const LONGLONG&) imposta un valore intero a 64 bit. (overload 2/3)
CInstance::SetWCHARSplat Il metodo SetWCHARSplat imposta una proprietà stringa.
CInstance::SetWORD Il metodo SetWORD imposta una proprietà WORD.

Commenti

Il distruttore per questa classe è CInstance::~CInstance.

I metodi della classe CInstance vengono usati per recuperare e impostare i valori delle proprietà. I tipi di dati delle proprietà vengono definiti usando tipi di dati CIM che possono essere visualizzati in un file mof. Quando si esegue una query o si imposta un valore di proprietà usando i metodi CInstance , è necessario usare un metodo compatibile con il tipo di dati CIM della proprietà. Nella tabella seguente sono elencati i tipi di dati CIM e i metodi CInstance get o set consentiti per accedere a una proprietà di tale tipo di dati.

Tipo di dati CIM	Tipi di metodo Get/Set di 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

Requisiti

Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	instance.h (include FwCommon.h)