Classe de fournisseur (provider.h)
[La classe Provider fait partie de L’infrastructure de fournisseur WMI, qui est maintenant considérée dans l’é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é affectant ces bibliothèques. Les API MI doivent être utilisées dans tout nouveau développement.]
La classe Provider est la classe de base pour la ou les classes que le fournisseur d’infrastructure prend en charge. La classe Provider encapsule les implémentations des méthodes d’IWbemServices et inclut plusieurs fonctions d’assistance. Un fournisseur d’infrastructure remplace l’une des méthodes de la classe Provider pour chaque fonctionnalité qu’il prend en charge. Par exemple, un fournisseur qui prend en charge le traitement des requêtes remplace la méthode Provider ::ExecQuery .
Une instance de la classe Provider est créée pour chaque classe WMI qui a un fournisseur d’infrastructure.
Le fournisseur a les types de membres suivants :
| Méthode | Description |
|---|---|
| Commiter | Retourne le instance actuel à WMI. |
| CreateNewInstance | Alloue un nouvel objet CInstance et retourne un pointeur vers celui-ci. |
| DeleteInstance | Supprime un instance. Appelé par WMI. |
| EnumerateInstances | Récupère toutes les instances de la classe d’un fournisseur d’infrastructure. Appelé par WMI. |
| ExecMethod | Appelle une méthode sur une classe ou un instance. Appelé par WMI. |
| ExecQuery | Traite une requête WQL (WMI Query Language). Appelé par WMI. |
| Purge | Appelé par l’infrastructure du fournisseur pour supprimer toute la mémoire inutile utilisée par le fournisseur. |
| GetLocalComputerName | Retourne une référence constante au nom de l’ordinateur au format CHString . |
| GetLocalInstancePath | Tente de générer un chemin d’accès d’objet complet à un instance spécifié. |
| Getobject | Récupère un instance d’une classe. Appelé par WMI. |
| GetProviderName | Récupère le nom du fournisseur. |
| MakeLocalPath | Génère un chemin d’accès instance complet à partir d’un chemin relatif. |
| PutInstance | Mises à jour un instance. Appelé par WMI. |
| SetCreationClassName | Définit la propriété de chaîne CreationClassName du instance donné sur le nom de ce fournisseur. |
| ValidateDeletionFlags | Détermine si un ensemble d’indicateurs est valide pour une opération de suppression. |
| ValidateEnumerationFlags | Détermine si un ensemble d’indicateurs est valide pour une énumération. |
| ValidateFlags | Détermine si un ensemble d’indicateurs est valide. |
| ValidateGetObjFlags | Détermine si un ensemble d’indicateurs est valide pour une opération de récupération de instance. |
| ValidateMethodFlags | Détermine si un ensemble d’indicateurs est valide pour une opération de méthode d’exécution. |
| ValidatePutInstanceFlags | Détermine si un ensemble d’indicateurs est valide pour une opération de mise à jour instance. |
| ValidateQueryFlags | Détermine si un ensemble d’indicateurs est valide pour une opération de requête. |
Héritage
La classe Provider implémente CThreadBase.
Méthodes
La classe Provider possède ces méthodes.
| Provider ::~Provider La fonction Provider ::~Provider est un destructeur pour la classe Provider. |
| Provider ::Commit La méthode Commit est utilisée pour envoyer un instance à WMI. Cette méthode est une fonction d’assistance et ne doit pas être remplacée. |
| Provider ::CreateNewInstance La méthode CreateNewInstance alloue un nouvel objet CInstance et retourne un pointeur vers celui-ci. |
| Provider ::D eleteInstance La méthode DeleteInstance est appelée par WMI pour supprimer un instance. (surcharge 2/2) |
| Provider ::D eleteInstance La méthode DeleteInstance est appelée par WMI pour supprimer un instance. (surcharge 1/2) |
| Provider ::EnumerateInstances La méthode EnumerateInstances est appelée par WMI pour récupérer toutes les instances de la classe d’un fournisseur d’infrastructure. |
| Provider ::ExecMethod La méthode ExecMethod est appelée par WMI pour appeler une méthode sur une classe ou un instance. (surcharge 1/2) |
| Provider ::ExecMethod La méthode ExecMethod est appelée par WMI pour appeler une méthode sur une classe ou un instance. (surcharge 2/2) |
| Provider ::ExecQuery La méthode ExecQuery est appelée par WMI pour traiter une requête WQL (WMI Query Language). |
| Provider ::Flush La méthode Flush est appelée par l’infrastructure du fournisseur pour supprimer toute la mémoire inutile utilisée par le fournisseur. |
| Provider ::GetLocalComputerName La méthode GetLocalComputerName retourne une référence constante au nom de l’ordinateur au format CHString. |
| Provider ::GetLocalInstancePath La méthode GetLocalInstancePath tente de créer un chemin d’accès d’objet complet à un instance spécifié. Cette méthode est une fonction d’assistance et ne doit pas être remplacée. |
| Provider ::GetNamespace La méthode GetNamespace retourne une référence constante au nom de l’espace de noms au format CHString. Le nom retourné est le deuxième paramètre initialement donné au constructeur du fournisseur. |
| Provider ::GetObject La méthode GetObject est appelée par WMI pour récupérer un instance d’une classe. (surcharge 1/3) |
| Provider ::GetObject La méthode GetObject est appelée par WMI pour récupérer un instance d’une classe. (surcharge 2/3) |
| Provider ::GetObject La méthode GetObject est appelée par WMI pour récupérer un instance d’une classe. (surcharge 3/3) |
| Provider ::GetProviderName La méthode GetProviderName récupère le nom de la classe utilisée dans le constructeur du fournisseur. |
| Provider ::MakeLocalPath La méthode MakeLocalPath génère un chemin d’instance complet à partir d’un chemin relatif. |
| Provider ::P rovider La méthode Provider crée un instance d’un fournisseur. Cette méthode fait partie de l’infrastructure du fournisseur WMI. |
| Provider ::P utInstance La méthode PutInstance met à jour un instance. (surcharge 2/2) |
| Provider ::P utInstance La méthode PutInstance met à jour un instance. (surcharge 1/2) |
| Provider ::SetCreationClassName La méthode SetCreationClassName définit la propriété de chaîne CreationClassName, le cas échéant, du instance donné sur le nom de ce fournisseur. |
| Provider ::ValidateDeletionFlags La méthode ValidateDeletionFlags détermine si un ensemble d’indicateurs est valide pour une opération de suppression. |
| Provider ::ValidateEnumerationFlags La méthode ValidateEnumerationFlags détermine si un ensemble d’indicateurs est valide pour une énumération. |
| Provider ::ValidateFlags La méthode ValidateFlags détermine si un ensemble d’indicateurs est valide. |
| Provider ::ValidateGetObjFlags La méthode ValidateGetObjFlags détermine si un ensemble d’indicateurs est valide pour une opération de récupération de instance. |
| Provider ::ValidateMethodFlags La méthode ValidateMethodFlags détermine si un ensemble d’indicateurs est valide pour une opération de méthode d’exécution. |
| Provider ::ValidatePutInstanceFlags La méthode ValidatePutInstanceFlags détermine si un ensemble d’indicateurs est valide pour une opération de mise à jour instance. |
| Provider ::ValidateQueryFlags La méthode ValidateQueryFlags détermine si un ensemble d’indicateurs est valide pour une opération de requête. |
Remarques
Le destructeur de cette classe est Provider ::~Provider.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | provider.h (inclure FwCommon.h) |