IVssBackupComponents::SetAdditionalRestores-Methode (vsbackup.h)

Artikel
08/27/2023

Die SetAdditionalRestores-Methode wird von einem Anforderer bei inkrementellen oder differenziellen Wiederherstellungsvorgängen verwendet, um Writern mitzuteilen, dass für eine bestimmte Komponente zusätzliche Wiederherstellungsvorgänge erforderlich sind, um sie vollständig abzurufen.

Syntax

HRESULT SetAdditionalRestores(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] bool               bAdditionalRestores
);

Parameter

[in] writerId

Writer-ID.

[in] ct

Typ der Komponente. Die möglichen Werte finden Sie unter VSS_COMPONENT_TYPE .

[in] wszLogicalPath

Mit Null beendete Breitzeichenzeichenfolge, die den logischen Pfad der hinzuzufügenden Komponente enthält.

Weitere Informationen finden Sie unter Logische Pfade von Komponenten.

Der Wert der Zeichenfolge, die den hier verwendeten logischen Pfad enthält, sollte dem Wert entsprechen, der verwendet wurde, als die Komponente mithilfe von IVssBackupComponents::AddComponent dem Sicherungssatz hinzugefügt wurde.

Der logische Pfad kann NULL sein.

Es gibt keine Einschränkungen für die Zeichen, die in einem logischen Pfad ohne NULL angezeigt werden können.

[in] wszComponentName

Breitzeichenzeichenfolge mit NULL-Beendigung, die den Namen der Komponente enthält.

Der Wert der Zeichenfolge sollte nicht NULL sein und dieselbe Komponente enthalten, die beim Hinzufügen der Komponente zum Sicherungssatz mithilfe von IVssBackupComponents::AddComponent verwendet wurde.

[in] bAdditionalRestores

Wenn der Wert dieses Parameters true ist, folgen dieser Wiederherstellung zusätzliche Wiederherstellungen der Komponente. Wenn der Wert false ist, folgen dieser Wiederherstellung keine weiteren Wiederherstellungen der Komponente.

Rückgabewert

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

Wert	Bedeutung
S_OK	Das zusätzliche wiederherstellungs-status wurde erfolgreich festgelegt.
E_INVALIDARG	Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY	Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE	Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen.
VSS_E_OBJECT_NOT_FOUND	Die Sicherungskomponente ist nicht vorhanden.
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.
VSS_E_UNEXPECTED	Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet.

Hinweise

Die von der SetAdditionalRestores-Methode bereitgestellten Informationen werden in der Regel von Writern 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 oft nicht möglich, zusätzliche differenzielle, inkrementelle oder Protokollwiederherstellungen durchzuführen, nachdem eine solche Wiederherstellung durchgeführt wurde.

Wenn Also SetAdditionalRestores für eine Komponente auf true festgelegt ist, bedeutet dies, dass ein solcher Writer seinen expliziten Wiederherstellungsmechanismus nicht ausführen sollte und erwarten sollte, dass zusätzliche differenzielle, inkrementelle oder Protokollwiederherstellungen durchgeführt werden.

Wenn SetAdditionalRestores für eine Komponente auf false festgelegt ist, kann die Anwendung nach der Wiederherstellung der Komponente ihren Wiederherstellungsvorgang abschließen und wieder online geschaltet werden.

Diese Methode muss vor IVssBackupComponents::P reRestore aufgerufen werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h)
Bibliothek	VssApi.lib

Weitere Informationen

IVssBackupComponents

IVssBackupComponents::P reRestore

VSS_COMPONENT_TYPE