Classe CInstance (instance.h)

[La classe CInstance fait partie du framework de fournisseur WMI qui est maintenant considéré dans son état final, et aucun développement, amélioration ou mise à jour supplémentaire ne sera disponible pour les problèmes non liés à la sécurité de ces bibliothèques. Les API MI doivent être utilisées dans tout nouveau développement.]

La classe CInstance est utilisée pour récupérer et mettre à jour les valeurs des propriétés définies pour les instances prises en charge par wMI Provider Framework. La classe CInstance fournit également l’accès à l’implémentation de l’infrastructure du fournisseur de l’interface CInstance .

Il n’est pas prévu que les enregistreurs de fournisseur devront dériver de cette classe. Utilisez Provider ::CreateNewInstance pour créer un instance de cette classe.

CInstance a les types de membres suivants :

Méthode	Description
Commiter	Retourne le instance actuel à WMI.
Getbool	Récupère une propriété booléenne.
GetByte	Récupère une propriété compatible BYTE.
GetCHString	Récupère une propriété de chaîne.
GetClassObjectInterface	Renvoie un pointeur d’interface IWbemClassObject .
GetDateTime	Renvoie une propriété datetime.
GetDOUBLE	Récupère une propriété DOUBLE .
GetDWORD	Récupère une propriété DWORD .
GetEmbeddedObject	Récupère une propriété CInstance incorporée.
GetMethodContext	Retourne un pointeur vers un objet MethodContext .
GetStatus	Détermine si une propriété existe et, le cas échéant, détermine son type.
GetStringArray	Récupère une propriété qui représente un tableau de chaînes.
GetTimeSpan	Récupère une propriété qui représente un intervalle de temps WMI.
GetVariant	Récupère une propriété VARIANT .
GetWBEMINT16	Récupère une propriété entière 16 bits.
GetWBEMINT64	Surchargé. Récupère une propriété de type entier 64 bits.
GetWCHAR	Récupère une propriété WCHAR .
GetWORD	Récupère une propriété WORD .
IsNull	Détermine si la valeur d’une propriété particulière est NULL.
Setbool	Définit une propriété booléenne .
SetByte	Définit une propriété BYTE .
SetCharSplat	Surchargé. Propriété de chaîne simple.
SetCHString	Surchargé. Propriété de chaîne simple.
SetDateTime	Définit une propriété datetime.
SetDOUBLE	Définit une propriété DOUBLE .
SetDWORD	Définit une propriété DWORD .
SetEmbeddedObject	Définit une propriété CInstance incorporée.
SetNull	Définit une propriété sur NULL.
SetStringArray	Définit une propriété qui représente un tableau de chaînes.
SetTimeSpan	Définit une propriété qui représente un intervalle de temps.
SetVariant	Définit une propriété VARIANT .
SetWBEMINT16	Définit une propriété entière 16 bits.
SetWBEMINT64	Surchargé. Définit une propriété entière de 64 bits.
SetWCHARSplat	Définit une propriété de chaîne WCHAR .
SetWORD	Définit une propriété WORD .

Méthodes

La classe CInstance possède ces méthodes.

CInstance ::Commit La méthode Commit retourne le instance actuel à WMI.
CInstance ::Getbool La méthode Getbool récupère une propriété booléenne.
CInstance ::GetByte La méthode GetByte récupère une propriété compatible BYTE.
CInstance ::GetCHString La méthode GetCHString récupère une propriété string.
CInstance ::GetClassObjectInterface La méthode GetClassObjectInterface retourne un pointeur d’interface IWbemClassObject.
CInstance ::GetDateTime La méthode GetDateTime renvoie une propriété datetime.
CInstance ::GetDOUBLE La méthode GetDOUBLE récupère une propriété DOUBLE.
CInstance ::GetDWORD La méthode GetDWORD récupère une propriété DWORD.
CInstance ::GetEmbeddedObject La méthode GetEmbeddedObject récupère un pointeur vers un objet CInstance incorporé. Le pointeur peut être utilisé pour obtenir et définir les propriétés de cet objet incorporé.
CInstance ::GetMethodContext La méthode GetMethodContext retourne un pointeur vers un objet MethodContext.
CInstance ::GetStatus La méthode GetStatus détermine si une propriété existe et, le cas échéant, détermine son type.
CInstance ::GetStringArray La méthode GetStringArray récupère une propriété qui représente un tableau de chaînes.
CInstance ::GetTimeSpan La méthode GetTimeSpan récupère une propriété qui représente un intervalle de temps WMI.
CInstance ::GetVariant La méthode GetVariant récupère une propriété VARIANT.
CInstance ::GetWBEMINT16 La méthode GetWBEMINT16 récupère une propriété entière 16 bits.
CInstance ::GetWBEMINT64 La méthode GetWBEMINT64 récupère une propriété entière 64 bits. (surcharge 1/3)
CInstance ::GetWBEMINT64 La méthode GetWBEMINT64 récupère une propriété entière 64 bits. (surcharge 3/3)
CInstance ::GetWBEMINT64 La méthode GetWBEMINT64 récupère une propriété entière 64 bits. (surcharge 2/3)
CInstance ::GetWCHAR La méthode GetWCHAR récupère une propriété de chaîne WCHAR.
CInstance ::GetWORD La méthode GetWORD récupère une propriété WORD.
CInstance ::IsNull La méthode IsNull détermine si la valeur d’une propriété particulière est NULL.
CInstance ::Setbool La méthode Setbool définit une propriété booléenne.
CInstance ::SetByte La méthode SetByte définit une propriété BYTE.
CInstance ::SetCharSplat La méthode SetCharSplat(LPCWSTR, DWORD) définit une chaîne.
CInstance ::SetCharSplat La méthode SetCharSplat(LPCWSTR, LPCSTR) définit une propriété de chaîne.
CInstance ::SetCharSplat La méthode SetCharSplat(LPCWSTR, LPCWSTR) définit une propriété string.
CInstance ::SetCHString La méthode SetCHString(LPCWSTR, const CHString&) définit une propriété string. (surcharge 2/2)
CInstance ::SetCHString La méthode SetCHString(LPCWSTR, LPCSTR) définit une propriété string.
CInstance ::SetCHString La méthode SetCHString(LPCWSTR, const CHString&) définit une propriété string. (surcharge 1/2)
CInstance ::SetDateTime La méthode SetDateTime définit une propriété datetime.
CInstance ::SetDOUBLE CInstance ::SetDOUBLE, méthode
CInstance ::SetDWORD La méthode SetDWORD définit une propriété DWORD.
CInstance ::SetEmbeddedObject La méthode SetEmbeddedObject définit une propriété CInstance incorporée.
CInstance ::SetNull La méthode SetNull définit une propriété sur NULL.
CInstance ::SetStringArray La méthode SetStringArray définit une propriété qui représente un tableau de chaînes.
CInstance ::SetTimeSpan La méthode SetTimeSpan définit une propriété qui représente un intervalle de temps.
CInstance ::SetVariant La méthode SetVariant définit une propriété VARIANT.
CInstance ::SetWBEMINT16 La méthode SetWBEMINT16 définit une propriété entière 16 bits.
CInstance ::SetWBEMINT64 La méthode SetWBEMINT64(LPCWSTR, const LONGLONG&) définit une valeur entière 64 bits. (surcharge 3/3)
CInstance ::SetWBEMINT64 La méthode SetWBEMINT64(LPCWSTR, const LONGLONG&) définit une valeur entière 64 bits. (surcharge 1/3)
CInstance ::SetWBEMINT64 La méthode SetWBEMINT64(LPCWSTR, const LONGLONG&) définit une valeur entière 64 bits. (surcharge 2/3)
CInstance ::SetWCHARSplat La méthode SetWCHARSplat définit une propriété string.
CInstance ::SetWORD La méthode SetWORD définit une propriété WORD.

Remarques

Le destructeur de cette classe est CInstance ::~CInstance.

Les méthodes de la classe CInstance sont utilisées pour récupérer et définir des valeurs de propriété. Les types de données de propriété sont définis à l’aide de types de données CIM qui peuvent être vus dans un fichier .mof. Lors de l’interrogation ou de la définition d’une valeur de propriété à l’aide de méthodes CInstance , il est nécessaire d’utiliser une méthode compatible avec le type de données CIM de la propriété. Le tableau suivant répertorie les types de données CIM et les méthodes cInstance get ou set autorisées pour accéder à une propriété de ce type de données.

Type de données CIM	Types de méthodes CInstance Get/Set
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

Configuration requise

Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	instance.h (inclure FwCommon.h)