Metodo CVssWriterEx::OnIdentifyEx (vswriter.h)
Restituisce un puntatore a un oggetto IVssCreateWriterMetadataEx .
OnIdentifyEx è un metodo virtuale. Viene implementato dalla classe di base CVssWriterEx , ma può essere sottoposto a override da classi derivate.
Sintassi
bool OnIdentifyEx(
[in] IVssCreateWriterMetadataEx *pMetadata
);
Parametri
[in] pMetadata
Puntatore a un oggetto IVssCreateWriterMetadataEx .
Valore restituito
Come implementato dalla classe di base, OnIdentifyEx 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
Il metodo OnIdentifyEx è identico al metodo OnIdentify , ad eccezione del fatto che restituisce un puntatore all'interfaccia IVssCreateWriterMetadataEx anziché un puntatore all'interfaccia IVssCreateWriterMetadata nel parametro pMetadata . Un writer può eseguire l'override di OnIdentify o OnIdentifyEx, ma non entrambi.
Gli autori non devono mai generare un'eccezione da questo metodo o da altri CVssWriter(Ex)::OnXxx metodo di callback.
I writer non devono mai chiamare il metodo CVssWriter::SetWriterFailure dal metodo OnIdentify o OnIdentifyEx .
Se questo metodo chiama il metodo CVssWriterEx2::GetSessionId , deve farlo nello stesso thread che ha chiamato questo metodo. Per altre informazioni, vedere Gestione degli eventi writer.
In risposta a un evento Identify generato da un'altra applicazione, un writer chiama OnIdentifyEx per creare un documento di metadati writer contenente informazioni sui componenti gestiti tramite l'interfaccia IVssCreateWriterMetadataEx .
L'applicazione che ha generato l'evento Identify recupera quindi il documento di metadati writer ed esamina le informazioni sul componente del writer usando l'interfaccia IVssExamineWriterMetadata .
Un evento Identify è necessario prima degli eventi che costituiscono una sequenza di backup o ripristino. Pertanto , OnIdentifyEx viene in genere chiamato per gestire un evento Identify in risposta alla chiamata di un richiedente a IVssBackupComponents::GatherWriterMetadata come parte di un'operazione di backup o ripristino.
Tuttavia, un evento Identify da solo non fa parte della sequenza di eventi che costituiscono una sequenza di backup o ripristino e il servizio VsS non impedisce la generazione di eventi Di identificazione, anche se è in corso una sequenza di backup o ripristino. Ad esempio, le applicazioni di gestione vss usano l'evento Identify per determinare e visualizzare lo stato dei writer nel sistema.
Per questo motivo, i writer non devono mai usare l'implementazione di OnIdentifyEx in uno dei modi seguenti:
- Come inizio della gestione di una sequenza di backup o ripristino
- Per impostare o mantenere le informazioni sullo stato del writer
Durante gli eventi PrepareForBackup, PrepareForSnapshot e PostSnapshot , un writer può usare il metodo GetIdentifyInformation per ottenere i metadati segnalati dal metodo OnIdentifyEx del writer.
Il ciclo di vita dell'oggetto IVssCreateWriterMetadataEx a cui punta il parametro pMetadata viene gestito dall'infrastruttura VSS.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vswriter.h (include Vss.h, VsWriter.h) |
| Libreria | VssApi.lib |