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 |
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 |
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | instance.h (include FwCommon.h) |