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