IVssComponent::GetRestoreMetadata-Methode (vswriter.h)
Die GetRestoreMetadata-Methode ruft private, writerspezifische Wiederherstellungsmetadaten ab, die möglicherweise während eines PreRestore-Ereignisses von CVssWriter::OnPreRestore mithilfe von IVssComponent::SetRestoreMetadata festgelegt wurden.
Nur ein Writer kann diese Methode aufrufen.
Syntax
HRESULT GetRestoreMetadata(
[out] BSTR *pbstrRestoreMetadata
);
Parameter
[out] pbstrRestoreMetadata
Eine Zeichenfolge, die die Wiederherstellungsmetadaten enthält.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Der Attributwert wurde erfolgreich zurückgegeben. |
|
Das angegebene Attribut weist keinen Wert auf. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
Hinweise
Diese Methode kann je nach Logik eines bestimmten Writers jederzeit aufgerufen werden.
Der Aufrufer sollte den Arbeitsspeicher des pbstrRestoreMetadata-Parameters durch Aufrufen von SysFreeString freigeben.
Wenn keine Sicherungsmetadaten festgelegt wurden, gibt GetBackupMetadata S_FALSE zurück.
Ein Writer, der die Wiederherstellungsmethode auf VSS_RME_RESTORE_TO_ALTERNATE_LOCATION festlegt, ohne eine alternative Standortzuordnung zu definieren, stellt einen Schreibfehler dar.
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 (einschließlich Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |