Metodo CVssWriter::OnPostRestore (vswriter.h)

  • Articolo

Il metodo OnPostRestore viene chiamato da un writer che segue 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.

OnPostRestore è un metodo virtuale. Viene implementato dalla classe di base CVssWriter , ma può essere sottoposto a override da classi derivate.

Sintassi

bool OnPostRestore(
  [in] IVssWriterComponents *pComponent
);

Parametri

[in] pComponent

Puntatore a un oggetto IVssWriterComponents passato da VSS per fornire al metodo l'accesso alle informazioni del componente del writer. Il valore di questo parametro può essere NULL se il richiedente non supporta i componenti (se CVssWriter::AreComponentsSelected restituisce false).

Valore restituito

Come implementato dalla classe base, OnPostRestore restituisce sempre true.

Qualsiasi altra implementazione di questo metodo deve restituire true tranne nel caso di un errore irreversibile. Se si verifica un errore irreversibile, il metodo deve chiamare il metodo CVssWriter::SetWriterFailure per fornire una descrizione dell'errore prima di restituire false. Se si verifica un errore non irreversibile, il metodo deve comunque chiamare SetWriterFailure ma restituire true. Se l'errore è causato da un problema temporaneo, il metodo deve specificare VSS_E_WRITERERROR_RETRYABLE nella chiamata a SetWriterFailure.

In tutti i casi in cui si verifica un errore, il metodo deve scrivere un evento nel registro eventi per segnalare il motivo esatto dell'errore.

Commenti

L'implementazione predefinita di questo metodo da parte della classe di base CVssWriter restituisce true senza eseguire alcuna altra operazione.

Se necessario, un writer deve rimuovere tutti i file temporanei e rilasciare tutte le risorse di sistema necessarie per la partecipazione al ripristino.

I writer non devono mai generare un'eccezione da questo metodo o da qualsiasi altro metodo CVssWriter(Ex)::OnXxx callback.

Con la generazione di un evento PostRestore , il documento dei componenti di backup di un richiedente diventa un documento di sola lettura. Pertanto, i tentativi di modificare il documento tramite l'interfaccia (ad esempio, chiamando IVssComponent::SetRestoreMetadata) avranno esito negativo nelle implementazioni utente di OnPostRestore.

Se questo metodo chiama il metodo CVssWriterEx2::GetSessionId, CVssWriter::SetWriterFailure o CVssWriterEx2::SetWriterFailureEx , deve farlo nello stesso thread denominato questo metodo. Per altre informazioni, vedere Gestione eventi writer.

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)
Libreria VssApi.lib

Vedi anche

CVssWriter

IVssWriterComponents