IWbemBackupRestore::Restore-Methode (wbemcli.h)

Artikel
03/03/2024

Die IWbemBackupRestore::Restore-Methode löscht den Inhalt des aktuellen Repositorys und stellt sie mit dem Inhalt einer zuvor angegebenen Sicherung wieder her.

Da die Windows-Verwaltungsinstrumentation (WMI) der Server für diese Schnittstelle ist und beendet werden muss, um diesen Vorgang erfolgreich abzuschließen, wird die COM-Verbindung unterbrochen, wenn dieser Aufruf erfolgreich ist.

Syntax

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

Parameter

[in] strRestoreFromFile

Konstante null-beendete Zeichenfolge mit 16-Bit-Unicode-Zeichen, die den Dateinamen der wiederherzustellenden Datei enthält. Die angegebene Datei sollte auf eine Datei verweisen, die zuvor mit IWbemBackupRestore::Backup erstellt wurde.

[in] lFlags

Eines der folgenden Flags aus der WBEM_BACKUP_RESTORE_FLAGS-Enumeration .

WBEM_FLAG_BACKUP_RESTORE_DEFAULT

Fährt aktive Clients nicht herunter. gibt einen Fehler zurück, falls vorhanden.

WBEM_FLAG_BACKUP_RESTORE_FORCE_SHUTDOWN

Beendet alle aktiven Clients.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste wird der Wert aufgeführt, der im HRESULT enthalten ist.

Hinweise

Der Standardmodus ist identisch mit dem Festlegen des Flags für den Erzwingungsmodus, das alle aktiven Verbindungen unterbricht. Dies führt zu Rpc-Fehlern (Remote Procedure Call) von aktiven COM-Verbindungen mit WMI , bis neue Verbindungen hergestellt werden.

Beispiele

Das folgende C++-Beispiel zeigt, wie Die IWbemBackupRestore::Restore-Methode aufgerufen wird .

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Wbemsvc.dll

Freigeben über