Metodo CVssWriter::OnIdentify (vswriter.h)

  • Articolo

Il metodo OnIdentify viene chiamato da un writer che segue la ricezione di un eventoIdentifi .

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

Sintassi

bool OnIdentify(
  [in] IVssCreateWriterMetadata *pMetadata
);

Parametri

[in] pMetadata

Puntatore a un oggetto IVssCreateWriterMetadata usato per costruire i metadati del writer.

Valore restituito

Come implementato dalla classe di base, OnIdentify 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 restituire false.

In tutti i casi in cui si verifica un errore, inclusi gli errori non irreversibili, il metodo deve scrivere una voce dettagliata 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.

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

I writer non devono mai chiamare il metodo CVssWriter::SetWriterFailure dal metodo OnIdentify o CVssWriterEx::OnIdentifyEx .

Se questo metodo chiama il metodo CVssWriterEx2::GetSessionId , deve farlo nello stesso thread che ha chiamato questo metodo. Per altre informazioni, vedere Gestione eventi writer.

In risposta a un evento Di identificazione generato da un'altra applicazione, un writer usa il gestore OnIdentify per creare un documento di metadati writer contenente informazioni sui componenti gestiti tramite l'interfaccia IVssCreateWriterMetadata .

L'applicazione che ha generato l'evento Identificazione recupera quindi il documento metadati writer ed esamina le informazioni del componente del writer usando l'interfaccia IVssExamineWriterMetadata .

È necessario un evento Di identificazione prima degli eventi che costituiscono una sequenza di backup o ripristino. Pertanto, OnIdentify è forse più in genere richiamato per gestire un evento Di identificazione in risposta alla chiamata di un richiedente a IVssBackupComponents::GatherWriterMetadata come parte di un'operazione di backup o ripristino.

Tuttavia, un eventoIdentifi non fa parte della sequenza di eventi che compongono un backup o un ripristino e il servizio VSS non impedisce la generazione, anche quando è in corso un backup o una sequenza di ripristino. Ad esempio, le applicazioni di gestione di VSS usano l'evento Identificazione per determinare e visualizzare lo stato dei writer nel sistema.

In questo caso, i writer non devono mai usare l'implementazione di OnIdentify nei modi seguenti:

  • Come inizio della gestione di un backup o ripristino
  • Per impostare o mantenere informazioni sullo stato del writer
Per altre informazioni sulle interazioni tra writer e eventi, vedere Gestione eventi writer .

Il ciclo di vita dell'oggetto IVssCreateWriterMetadata passato in OnIdentify viene gestito dall'infrastruttura 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)
Libreria VssApi.lib

Vedi anche

CVssWriter

IVssBackupComponents::GatherWriterMetadata

IVssCreateWriterMetadata