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