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 |
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 |
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) |