IVssCreateWriterMetadata::SetBackupSchema-Methode (vswriter.h)

  • Artikel

Die SetBackupSchema-Methode wird von einem Writer verwendet, um in seinem Writer-Metadatendokument anzugeben, an welcher Art von Sicherungsvorgängen er teilnehmen kann.

Syntax

HRESULT SetBackupSchema(
  [in] DWORD dwSchemaMask
);

Parameter

[in] dwSchemaMask

Die Arten von Sicherungsvorgängen, die dieser Writer unterstützt, ausgedrückt als Bitmaske von VSS_BACKUP_SCHEMA Enumerationswerten.

Für Express-Writer werden nur die Werte VSS_BS_UNDEFINED, VSS_BS_COPY und VSS_BS_INDEPENDENT_SYSTEM_STATE unterstützt.

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

Wert Bedeutung
S_OK
0x00000000L
 Die Fehlermeldung wurde erfolgreich festgelegt.
E_INVALIDARG
0x80070057L
 Das Argument sicherungsschema ist ungültig.
E_OUTOFMEMORY
0x8007000EL
 Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_INVALID_XML_DOCUMENT
0x80042311L
 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_NOT_SUPPORTED
0x8004232FL
 Der Aufrufer hat einen VSS_BACKUP_SCHEMA Wert angegeben, der für Express-Writer nicht unterstützt wird.

Hinweise

Wenn kein Schema explizit von SetBackupSchema festgelegt wird, wird dem Writer der Standardwert VSS_BS_UNDEFINED zugewiesen: Der Writer unterstützt nur einfache vollständige Sicherung und Wiederherstellung ganzer Dateien (wie durch VSS_BT_FULL definiert), es gibt keine Unterstützung für inkrementelle oder differenzielle Sicherungen, und Teildateien werden nicht unterstützt.

Anforderer rufen IVssExamineWriterMetadata::GetBackupSchema auf, um die Sicherungsschemas eines Writers abzurufen, wie von SetBackupSchema festgelegt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vswriter.h (enthalten Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

IVssCreateWriterMetadata

IVssExamineWriterMetadata::GetBackupSchema

VSS_BACKUP_SCHEMA