Classe CVssWriter (vswriter.h)
La classe CVssWriter è una classe base astratta che definisce l'interfaccia in base alla quale un writer sincronizza il proprio stato con VSS e altri writer.
Ogni writer deve creare un'istanza di un oggetto derivato da CVssWriter.
Gli oggetti derivati da CVssWriter devono fornire implementazioni per tutti i metodi virtuali puri di CVssWriter.
Un writer può eseguire l'override di uno o tutti i metodi virtuali di CVSWriter.
Per partecipare a VSS, un writer deve prima chiamare CVssWriter::Initialize e quindi chiamare CVssWriter::Subscribe.
Un writer termina la partecipazione chiamando CVssWriter::Unsubscribe.
La classe di base CVssWriter è responsabile del ciclo di vita delle interfacce passate ai gestori eventi. Il comportamento predefinito include quanto segue:
- Istanza dell'interfaccia IVssWriterComponents passata a: CVssWriter::OnPrepareBackup
- Istanza dell'interfaccia IVssCreateWriterMetadata passata a CVssWriter::OnIdentify.
Metodi
La classe CVssWriter include questi metodi.
| CVssWriter::~CVssWriter ~CVssWriter è il distruttore dell'oggetto classe CVssWriter. |
| CVssWriter::AreComponentsSelected Il metodo AreComponentsSelected indica se un richiedente è in esecuzione in modalità componente e supporta la selezione di singoli componenti di cui eseguire il backup o il backup di interi volumi. |
| CVssWriter::CVssWriter CVssWriter è il costruttore dell'oggetto classe CVssWriter. |
| CVssWriter::GetBackupType Il metodo GetBackupType indica il tipo di backup da eseguire. |
| CVssWriter::GetContext Le informazioni GetContext restituiscono il contesto corrente per eventuali copie shadow in corso o possibili. |
| CVssWriter::GetCurrentLevel Il metodo GetCurrentLevel restituisce il livello di applicazione corrente. |
| CVssWriter::GetCurrentSnapshotSetId Il metodo GetCurrentSnapshotSetId restituisce l'identificatore univoco del set di copie shadow. |
| CVssWriter::GetCurrentVolumeArray Il metodo GetCurrentVolumeArray restituisce i nomi dei volumi originali e i percorsi UNC delle condivisioni file remote originali che appartengono al set di copie shadow come matrice di stringhe di caratteri wide con terminazione Null. Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP e Windows Server 2003: le condivisioni file remote non sono supportate fino a Windows 8 e Windows Server 2012. |
| CVssWriter::GetCurrentVolumeCount Il metodo GetCurrentVolumeCount restituisce il numero di volumi nel set di copie shadow. |
| CVssWriter::GetRestoreType Il metodo GetRestoreType restituisce il tipo di ripristino di un writer che partecipa. |
| CVssWriter::GetSnapshotDeviceName Il metodo GetSnapshotDeviceName restituisce il nome del dispositivo che ospita la copia shadow del volume o della condivisione file specificata. |
| CVssWriter::Initialize Inizializza un oggetto CVssWriter e consente a un'applicazione writer di interagire con VSS. |
| CVssWriter::InstallAlternateWriter Non supportato. (CVssWriter.InstallAlternateWriter) |
| CVssWriter::IsBootableSystemStateBackedUp Il metodo IsBootableSystemStateBackedUp indica se verrà eseguito il backup dello stato di avvio. |
| CVssWriter::IsPartialFileSupportEnabled Il metodo IsPartialFileSupportEnabled determina se il supporto parziale dei file è abilitato o disabilitato. |
| CVssWriter::IsPathAffected Il metodo IsPathAffected determina se la directory o il file specificato è incluso nel set di copia shadow corrente. Il percorso della directory o del file può essere un percorso locale o un percorso UNC di una condivisione file remota. |
| CVssWriter::OnAbort Il metodo OnAbort viene chiamato da un writer che segue un evento Abort emesso dal Servizio Copia Shadow che indica che un'operazione di copia shadow è stata terminata in modo anomalo. Il writer usa questo metodo per eseguire la pulizia dal tentativo di partecipare a tale operazione. |
| CVssWriter::OnBackOffIOOnVolume Non supportato. (CVssWriter.OnBackOffIOOnVolume) |
| CVssWriter::OnBackupComplete Il metodo OnBackupComplete viene chiamato da un writer che segue un evento BackupComplete. Viene usato per eseguire operazioni considerate necessarie dopo un backup. Queste operazioni non possono tuttavia modificare il documento Componenti di backup. |
| CVssWriter::OnBackupShutdown Il metodo OnBackupShutdown viene chiamato da un writer che segue un evento BackupShutdown. Viene usato per eseguire operazioni considerate necessarie quando un'applicazione di backup viene arrestata, in particolare in caso di arresto anomalo dell'applicazione di backup. |
| CVssWriter::OnContinueIOOnVolume Non supportato. (CVssWriter.OnContinueIOOnVolume) |
| CVssWriter::OnFreeze Il metodo OnFreeze viene chiamato da un writer alla ricezione di un evento Freeze all'inizio di un blocco della copia shadow. Un writer usa questo metodo per eseguire operazioni necessarie per partecipare al blocco o per veto il blocco. |
| CVssWriter::OnIdentify Il metodo OnIdentify viene chiamato da un writer dopo la ricezione di un evento Identify. |
| CVssWriter::OnPostRestore Il metodo OnPostRestore viene chiamato da un writer dopo un evento PostRestore. Viene usato per eseguire operazioni considerate necessarie dopo il ripristino dei file su disco da parte di un richiedente. Queste operazioni non possono tuttavia modificare il documento Componenti di backup. |
| CVssWriter::OnPostSnapshot Il metodo OnPostSnapshot viene chiamato da un writer dopo un evento PostSnapshot. |
| CVssWriter::OnPrepareBackup Il metodo OnPrepareBackup viene chiamato da un writer che segue un evento PrepareForBackup. Questo metodo viene usato per configurare lo stato di un writer e i relativi componenti in preparazione a un'operazione di backup. |
| CVssWriter::OnPrepareSnapshot Il metodo OnPrepareSnapshot viene chiamato da un writer per gestire un evento PrepareForSnapshot. Viene usata per eseguire operazioni necessarie per preparare un writer a partecipare alla copia shadow o per assegnare un veto a una copia shadow. |
| CVssWriter::OnPreRestore Il metodo OnPreRestore viene chiamato da un writer che segue un evento PreRestore. |
| CVssWriter::OnThaw Il metodo OnThaw viene chiamato da un writer che segue un evento Thaw. |
| CVssWriter::OnVSSApplicationStartup Non supportato. (CVssWriter.OnVSSApplicationStartup) |
| CVssWriter::OnVSSShutdown Non supportato. (CVssWriter.OnVssShutdown) |
| CVssWriter::SetWriterFailure Il metodo SetWriterFailure indica che questo writer ha rilevato una condizione di errore e imposta una condizione di errore. |
| CVssWriter::Subscribe Il metodo Subscribe sottoscrive il writer con VSS. |
| CVssWriter::Unsubscribe Il metodo Unsubscribe annulla la sottoscrizione del writer con VSS. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vswriter.h (include Vss.h, VsWriter.h) |