IVssComponent::GetAdditionalRestores-Methode (vswriter.h)

Die GetAdditionalRestores-Methode wird von einem Writer während inkrementeller oder differenzieller Wiederherstellungsvorgänge verwendet, um zu bestimmen, ob für eine bestimmte Komponente zusätzliche Wiederherstellungsvorgänge erforderlich sind, um sie vollständig abzurufen.

Entweder ein Writer oder ein Anforderer kann diese Methode aufrufen.

Syntax

HRESULT GetAdditionalRestores(
  [out] bool *pbAdditionalRestores
);

Parameter

[out] pbAdditionalRestores

Die Adresse einer vom Aufrufer zugewiesenen Variablen, die true empfängt, wenn für die aktuelle Komponente zusätzliche Wiederherstellungen durchgeführt werden, oder andernfalls false .

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Wert	Bedeutung
S_OK	Der Attributwert wurde erfolgreich zurückgegeben.
S_FALSE	Das angegebene Attribut weist keinen Wert auf.
E_INVALIDARG	Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY	Der Aufrufer verfügt nicht über 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

Der von GetAdditionalRestores zurückgegebene Wert ist false, es sei denn, während eines Wiederherstellungsvorgangs ruft ein Anforderer IVssBackupComponents::SetAdditionalRestores auf.

GetAdditionalRestores sollte verwendet werden, um zu überprüfen, ob es erforderlich ist, mehrere Sicherungssätze zum vollständigen Wiederherstellen einer Komponente zu verwenden. Eine Komponente kann zuerst durch Wiederherstellen von Daten aus einer vollständigen Sicherung und anschließendes Aktualisieren dieser Daten aus einer oder mehreren nachfolgenden inkrementellen oder differenziellen Sicherungen abgerufen werden.

Die GetAdditionalRestores-Methode wird in der Regel von Autoren verwendet, die einen expliziten Wiederherstellungsmechanismus als Teil ihres PostRestore-Ereignishandlers (CVssWriter::OnPostRestore) unterstützen – für instance, die Exchange Server und Datenbankanwendungen wie SQL Server. Für diese Anwendungen ist es häufig nicht möglich, zusätzliche differenzielle, inkrementelle Oder Protokollwiederherstellungen durchzuführen, nachdem eine solche Wiederherstellung durchgeführt wurde.

Wenn GetAdditionalRestores daher true für eine Komponente zurückgibt, sollte ein solcher Writer seinen expliziten Wiederherstellungsmechanismus nicht ausführen und erwarten, dass zusätzliche differenzielle, inkrementelle oder Protokollwiederherstellungen durchgeführt werden.

Wenn SetAdditionalRestoresfalse zurückgibt, kann der Writer nach Abschluss der Wiederherstellung beim Behandeln des PostRestore-Ereignisses seinen Wiederherstellungsvorgang abschließen und wieder online geschaltet werden.

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

Weitere Informationen

IVssComponent