Partager via


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)