IVssBackupComponentsEx2::SetRollForward-Methode (vsbackup.h)

Artikel
08/27/2023

Legt den Rollforward-Vorgangstyp für eine Komponente fest und gibt den Wiederherstellungspunkt für einen partiellen Rollforwardvorgang an.

Syntax

HRESULT SetRollForward(
  [in] VSS_ID               writerId,
  [in] VSS_COMPONENT_TYPE   ct,
  [in] LPCWSTR              wszLogicalPath,
  [in] LPCWSTR              wszComponentName,
  [in] VSS_ROLLFORWARD_TYPE rollType,
  [in] LPCWSTR              wszRollForwardPoint
);

Parameter

[in] writerId

Die GUID (Globally Unique Identifier) der Writer-Klasse.

[in] ct

Der Typ der Komponente. Die möglichen Werte finden Sie in der VSS_COMPONENT_TYPE-Enumeration .

[in] wszLogicalPath

Eine mit NULL endende Breitzeichenzeichenfolge, die den logischen Pfad der 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 mit der Zeichenfolge identisch sein, die beim Hinzufügen der Komponente verwendet 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

Eine mit NULL endende Breitzeichenzeichenfolge, die den Namen der Komponente enthält.

Die Zeichenfolge darf nicht NULL sein und sollte den gleichen Komponentennamen wie die Zeichenfolge enthalten, die verwendet wurde, als die Komponente dem Sicherungssatz mithilfe der IVssBackupComponents::AddComponent-Methode hinzugefügt wurde.

[in] rollType

Ein VSS_ROLLFORWARD_TYPE Enumerationswert, der den Typ des auszuführenden Rollforwardvorgangs angibt.

[in] wszRollForwardPoint

Eine mit NULL endende Breitzeichenzeichenfolge, die den Roll forward-Wiederherstellungspunkt angibt.

Das Format dieser Zeichenfolge wird vom Writer definiert und kann ein Zeitstempel, eine Protokollsequenznummer (Log Sequence Number, LSN) oder ein beliebiger vom Writer definierter Marker sein.

Rückgabewert

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

Wert	Bedeutung
S_OK	Der Rollforward-Vorgangstyp und der Wiederherstellungspunkt wurden 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	Diese Methode wurde während eines Wiederherstellungsvorgangs nicht aufgerufen.
VSS_E_OBJECT_NOT_FOUND	Die angegebene Komponente wurde nicht gefunden.
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 SetRollForward-Methode kann nur während eines Wiederherstellungsvorgangs aufgerufen werden.

Ein Writer gibt an, dass er diese Methode unterstützt, indem er das flag VSS_BS_ROLLFORWARD_RESTORE in seiner Sicherungsschemamaske festlegt.

Weitere Informationen finden Sie unter Festlegen von VSS-Wiederherstellungsoptionen.

Anforderungen

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

Weitere Informationen

IVssBackupComponentsEx2

IVssComponentEx::GetRollForward

VSS_BACKUP_SCHEMA

VSS_ROLLFORWARD_TYPE

Freigeben über