IVssComponent::SetBackupMetadata-Methode (vswriter.h)

Die SetBackupMetadata-Methode legt Sicherungsmetadaten mit der -Komponente fest.

Ein Writer kann diese Methode nur während eines Sicherungsvorgangs aufrufen.

Diese Methode kann nicht aufgerufen werden, wenn ein BackupComplete-Ereignis (CVssWriter::OnBackupComplete) oder BackupShutdown (CVssWriter::OnBackupShutdown) behandelt wird.

Syntax

HRESULT SetBackupMetadata(
  [in] LPCWSTR wszData
);

Parameter

[in] wszData

Eine MIT NULL beendete Breitzeichenzeichenfolge, die die Sicherungsmetadaten enthält.

Rückgabewert

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

Wert Bedeutung
S_OK
Das Element wurde erfolgreich festgelegt.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_OBJECT_ALREADY_EXISTS
Für diese Komponente wurden bereits private Metadaten geschrieben.
VSS_E_BAD_STATE
Diese Methode wurde nicht von einem Writer aufgerufen, oder wenn sie von einem Writer aufgerufen wurde, wurde sie entweder während eines Sicherungsvorgangs nicht aufgerufen oder während der Behandlung eines BackupComplete- oder BackupShutdown-Ereignisses aufgerufen.

Hinweise

SetBackupMetadata legt private, writerspezifische Metadaten fest, die einen Sicherungsvorgang beschreiben.

Das Format muss keiner VSS-Metadatenspezifikation entsprechen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [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

IVssComponent

IVssComponent::GetBackupMetadata

IVssComponent::SetRestoreMetadata