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