Interface IWbemBackupRestore (wbemcli.h)

  • Article

L’interface IWbemBackupRestore sauvegarde et restaure le contenu du référentiel WMI. Le contenu affecté du dépôt est des données statiques, telles que les définitions de classe compilées dans le référentiel lorsqu’un fichier MOF est chargé. Les données dynamiques fournies par le biais des fournisseurs ne sont pas incluses.

Héritage

L’interface IWbemBackupRestore hérite de l’interface IUnknown. IWbemBackupRestore a également les types de membres suivants :

Méthodes

L’interface IWbemBackupRestore utilise ces méthodes.

 
IWbemBackupRestore ::Backup

La méthode IWbemBackupRestore ::Backup sauvegarde le contenu du dépôt statique dans un fichier distinct.
IWbemBackupRestore ::Restore

La méthode IWbemBackupRestore ::Restore supprime le contenu du dépôt actuel et les restaure avec le contenu d’une sauvegarde spécifiée précédemment.

Remarques

Le mode par défaut est identique à la définition de l’indicateur de mode force, qui interrompt toutes les connexions actives. Cela entraîne des erreurs d’appel de procédure distante (RPC) à partir de toutes les connexions COM actives à WMI jusqu’à ce que de nouvelles connexions soient établies.

Il ne peut y avoir aucune connexion active au dépôt pendant une opération de restauration. Pour cette raison, l’opération de restauration échoue si des paramètres par défaut sont utilisés et qu’il existe des connexions actives. Un indicateur peut être spécifié pour interrompre toutes les connexions actives.

Note Le client qui effectue l’appel doit avoir le privilège approprié activé. La sauvegarde nécessite le privilège SE_RESTORE_NAME , tandis que la restauration nécessite SE_RESTORE_NAME. Pour activer un privilège, une application cliente doit s’exécuter sous un compte d’utilisateur disposant de ce privilège, et le privilège doit être activé à l’aide de la fonction Windows AdjustTokenPrivileges .
 
Pour les ordinateurs exécutant Windows, tout utilisateur local peut effectuer ces appels, mais les utilisateurs distants doivent avoir le droit d’accès WBEM_FULL_WRITE_REP à l’espace de noms racine.

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 wbemcli.h (inclure Wbemidl.h)

Voir aussi

API COM pour WMI