Freigeben über


IVssBackupComponentsEx2::SetRollForward-Methode (vsbackup.h)

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