IVssBackupComponents::SetBackupState-Methode (vsbackup.h)

Artikel
08/27/2023

Die SetBackupState-Methode definiert eine Gesamtkonfiguration für einen Sicherungsvorgang.

Syntax

HRESULT SetBackupState(
  [in] bool            bSelectComponents,
  [in] bool            bBackupBootableSystemState,
  [in] VSS_BACKUP_TYPE backupType,
  [in] bool            bPartialFileSupport
);

Parameter

[in] bSelectComponents

Gibt an, ob sich ein Sicherungs- oder Wiederherstellungsvorgang im Komponentenmodus befindet.

Der Vorgang im Komponentenmodus unterstützt das selektive Sichern festgelegter einzelner Komponenten (was deren Ausschluss zulassen kann) oder nur das Sichern aller Dateien und Komponenten auf einem Volume.

Der Boolesche Wert ist true , wenn der Vorgang im Komponentenmodus ausgeführt wird, und false , falls nicht.

[in] bBackupBootableSystemState

Gibt an, ob eine startbare Systemstatussicherung ausgeführt wird.

[in] backupType

Ein VSS_BACKUP_TYPE Enumerationswert, der den Typ der auszuführenden Sicherung angibt.

[in] bPartialFileSupport

Optional. Wenn der Wert dieses Parameters true ist, ist die teilweise Dateiunterstützung aktiviert. Der Standardwert für dieses Argument ist false.

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Wert	Bedeutung
S_OK	Legen Sie den Sicherungsstatus erfolgreich fest.
E_INVALIDARG	Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY	Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE	Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht in der richtigen Sequenz aufgerufen.
VSS_E_INVALID_XML_DOCUMENT	Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
VSS_E_UNEXPECTED	Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet.

Hinweise

Anwendungen müssen SetBackupState aufrufen, bevor IVssBackupComponents::P repareForBackup aufgerufen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h)
Bibliothek	VssApi.lib

Weitere Informationen

IVssBackupComponents

VSS_BACKUP_TYPE

Freigeben über