Metodo IVssBackupComponentsEx2::SetRollForward (vsbackup.h)

Articolo
03/13/2024

Imposta il tipo di operazione di roll forward per un componente e specifica il punto di ripristino per un'operazione di roll forward parziale.

Sintassi

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

Parametri

[in] writerId

Identificatore univoco globale (GUID) della classe writer.

[in] ct

Tipo del componente. Vedere l'enumerazione VSS_COMPONENT_TYPE per i valori possibili.

[in] wszLogicalPath

Stringa di caratteri wide con terminazione Null contenente il percorso logico del componente. Per altre informazioni, vedere Percorso logico dei componenti.

Il valore della stringa contenente il percorso logico usato qui deve corrispondere alla stringa usata al momento dell'aggiunta del componente.

Il percorso logico può essere NULL.

Non esistono restrizioni sui caratteri che possono essere visualizzati in un percorso logico non NULL .

[in] wszComponentName

Stringa di caratteri wide con terminazione Null contenente il nome del componente.

La stringa non può essere NULL e deve contenere lo stesso nome del componente usato quando il componente è stato aggiunto al set di backup usando il metodo IVssBackupComponents::AddComponent .

[in] rollType

Valore di enumerazione VSS_ROLLFORWARD_TYPE che indica il tipo di operazione di roll forward da eseguire.

[in] wszRollForwardPoint

Stringa di caratteri wide con terminazione Null che specifica il punto di ripristino roll forward.

Il formato di questa stringa è definito dal writer e può essere un timestamp, un numero di sequenza di log (LSN) o qualsiasi marcatore definito dal writer.

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore	Significato
S_OK	Il tipo di operazione di roll forward e il punto di ripristino sono stati impostati correttamente.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o in altre risorse di sistema.
VSS_E_BAD_STATE	Questo metodo non è stato chiamato durante un'operazione di ripristino.
VSS_E_OBJECT_NOT_FOUND	Impossibile trovare il componente specificato.
VSS_E_UNEXPECTED	Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato.

Commenti

Il metodo SetRollForward può essere chiamato solo durante un'operazione di ripristino.

Un writer indica che supporta questo metodo impostando il flag VSS_BS_ROLLFORWARD_RESTORE nella relativa maschera dello schema di backup.

Per altre informazioni, vedere Impostazione delle opzioni di ripristino vss.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria	VssApi.lib

Vedi anche

IVssBackupComponentsEx2

IVssComponentEx::GetRollForward

VSS_BACKUP_SCHEMA

VSS_ROLLFORWARD_TYPE

Condividi tramite