IWbemBackupRestore ::Restore, méthode (wbemcli.h)

Article
03/06/2024

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.

Étant donné que Windows Management Instrumentation (WMI) est le serveur de cette interface et doit être arrêté pour mener à bien cette opération, la connexion COM est interrompue si cet appel réussit.

Syntaxe

HRESULT Restore(
  [in] LPCWSTR strRestoreFromFile,
  [in] long    lFlags
);

Paramètres

[in] strRestoreFromFile

Chaîne constante avec fin null de caractères Unicode 16 bits qui contient le nom de fichier du fichier à restaurer. Le fichier spécifié doit pointer vers un fichier créé précédemment avec IWbemBackupRestore ::Backup.

[in] lFlags

L’un des indicateurs suivants de l’énumération WBEM_BACKUP_RESTORE_FLAGS .

WBEM_FLAG_BACKUP_RESTORE_DEFAULT

N’arrête pas les clients actifs ; retourne une erreur s’il en existe.

WBEM_FLAG_BACKUP_RESTORE_FORCE_SHUTDOWN

Arrête tous les clients actifs.

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique l’état de l’appel de méthode. La liste suivante répertorie la valeur contenue dans le HRESULT.

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) entre les connexions COM actives et WMI, jusqu’à ce que de nouvelles connexions soient établies.

Exemples

L’exemple C++ suivant montre comment appeler la méthode IWbemBackupRestore ::Restore .

// The pInt variable is of type IWbemBackupRestore*
pInt->Restore(
        L"c:\\\\Windows\\System32\\wbem\\repository\\back.x",
        WBEM_FLAG_BACKUP_RESTORE_FORCE_SHUTDOWN
      );

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)
Bibliothèque	Wbemuuid.lib
DLL	Wbemsvc.dll

Partager via