IVssComponent::SetRestoreMetadata-Methode (vswriter.h)

Die SetRestoreMetadata-Methode legt writerspezifische Metadaten für die aktuelle Komponente fest.

Nur ein Writer kann diese Methode aufrufen, und zwar nur im Kontext der Implementierung von CVssWriter::OnPreRestore.

Syntax

HRESULT SetRestoreMetadata(
  [in] LPCWSTR wszRestoreMetadata
);

Parameter

[in] wszRestoreMetadata

Eine vom Aufrufer zugeordnete NULL-beendete Breitzeichenzeichenfolge, die die Wiederherstellungsmetadaten für die Komponente 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	Die -Methode wurde außerhalb des Kontexts eines Writers aufgerufen, der ein PreRestore-Ereignis behandelt.

Hinweise

IVssComponent::SetRestoreMetadata legt private, writerspezifische Metadaten fest, die von einem Writer während eines Wiederherstellungsvorgangs verwendet werden können.

Das Format muss keiner VSS-Metadatenspezifikation entsprechen.

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

Weitere Informationen

IVssComponent

IVssComponent::GetRestoreMetadata

IVssComponent::SetBackupMetadata