IVssComponentEx::GetRollForward-Methode (vswriter.h)

Ruft den Rollforward-Vorgangstyp für eine Komponente und den Wiederherstellungspunkt für einen partiellen Rollforward-Vorgang ab.

Syntax

HRESULT GetRollForward(
  [out] VSS_ROLLFORWARD_TYPE *pRollType,
  [out] BSTR                 *pbstrPoint
);

Parameter

[out] pRollType

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

[out] pbstrPoint

Die Adresse einer vom Aufrufer zugeordneten Variablen, die eine null-endende Breitzeichenzeichenfolge empfängt, die den Roll forward-Wiederherstellungspunkt angibt.

Rückgabewert

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

Wert Bedeutung
S_OK
Der Vorgang wurde durchgeführt.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.

Hinweise

Die GetRollForward-Methode kann nur während eines Wiederherstellungsvorgangs aufgerufen werden.

Wenn der Aufruf von GetRollForward erfolgreich ist, ist der Aufrufer dafür verantwortlich, die im pRollType-Parameter zurückgegebene Zeichenfolge durch Aufrufen der SysFreeString-Funktion freizugeben.

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 vswriter.h (enthalten Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

IVssBackupComponentsEx2::SetRollForward

IVssComponentEx

VSS_BACKUP_SCHEMA

VSS_ROLLFORWARD_TYPE