IVssBackupComponents::FreeWriterMetadata-Methode (vsbackup.h)

Die FreeWriterMetadata-Methode gibt Systemressourcen frei, die beim Aufruf von IVssBackupComponents::GatherWriterMetadata zugeordnet wurden.

Syntax

HRESULT FreeWriterMetadata();

Rückgabewert

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

Wert Bedeutung
S_OK
Die Writermetadaten wurden erfolgreich freigegeben.
VSS_E_BAD_STATE
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen.

Hinweise

Diese Methode sollte nie vor dem Abschluss von IVssBackupComponents::GatherWriterMetadata aufgerufen werden. Das Ergebnis des Aufrufs der -Methode vor Abschluss der Metadatensammlung ist undefiniert.

Nachdem Writermetadaten freigegeben wurden, können sie vom aktuellen instance der IVssBackupComponents-Schnittstelle nicht mehr wiederhergestellt werden. Es ist erforderlich, eine neue instance von IVssBackupComponents zu erstellen und die IVssBackupComponents::GatherWriterMetadata-Methode erneut aufzurufen.

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 (enthalten VsBackup.h, Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

IVssBackupComponents

IVssBackupComponents::GatherWriterMetadata