IVssComponent::GetBackupOptions-Methode (vswriter.h)

Die GetBackupOptions-Methode gibt die Sicherungsoptionen zurück, die für den Writer angegeben sind, der die aktuell ausgewählte Komponente oder Komponente verwaltet, die von einem Anforderer mithilfe von IVssBackupComponents::SetBackupOptions festgelegt wurde.

Entweder ein Writer oder ein Anforderer kann diese Methode aufrufen.

Syntax

HRESULT GetBackupOptions(
  [out] BSTR *pbstrBackupOptions
);

Parameter

[out] pbstrBackupOptions

Die Adresse einer vom Aufrufer zugewiesenen Variablen, die eine Zeichenfolge empfängt, die die Sicherungsoptionen für den aktuellen Writer enthält.

Rückgabewert

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

Wert Bedeutung
S_OK
Der Attributwert wurde erfolgreich zurückgegeben.
S_FALSE
Für diese Komponente wurden keine Sicherungsoptionen angegeben.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_INVALID_XML_DOCUMENT
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.

Hinweise

Wenn keine Sicherungsoptionen festgelegt wurden, wird S_FALSE zurückgegeben.

Wenn der Aufruf von GetBackupOptions erfolgreich ist, ist der Aufrufer dafür verantwortlich, die im pbstrBackupOptions-Parameter zurückgegebene Zeichenfolge durch Aufrufen der SysFreeString-Funktion freizugeben.

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

IVssBackupComponents::SetBackupOptions

IVssComponent

IVssComponent::GetRestoreOptions