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 |
---|---|
|
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
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 |