Interface IWbemBackupRestore (wbemcli.h)

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

Héritage

L’interface IWbemBackupRestore hérite de l’interface IUnknown . IWbemBackupRestore possède également ces types de membres :

Méthodes

L’interface IWbemBackupRestore a ces méthodes.

IWbemBackupRestore::Backup La méthode IWbemBackupRestore::Backup sauvegarde le contenu du référentiel statique dans un fichier distinct.
IWbemBackupRestore::Restore La méthode IWbemBackupRestore::Restore supprime le contenu du référentiel actuel et les restaure avec le contenu d’une sauvegarde spécifiée précédemment.

Notes

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

Il ne peut y avoir aucune connexion active au référentiel pendant une opération de restauration. Pour cette raison, l’opération de restauration échoue si les 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 effectuant 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 disposer du droit d’accès WBEM_FULL_WRITE_REP à l’espace de noms racine.

Configuration requise

Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wbemcli.h (include Wbemidl.h)

Voir aussi

API COM pour WMI