Méthode CVssWriter ::OnIdentify (vswriter.h)

La méthode OnIdentify est appelée par un rédacteur après la réception d’un événement Identifier .

OnIdentify est une méthode virtuelle. Il est implémenté par la classe de base CVssWriter , mais peut être remplacé par des classes dérivées.

Syntaxe

bool OnIdentify(
  [in] IVssCreateWriterMetadata *pMetadata
);

Paramètres

[in] pMetadata

Pointeur vers un objet IVssCreateWriterMetadata utilisé pour construire les métadonnées de l’enregistreur.

Valeur retournée

Comme implémenté par la classe de base, OnIdentify retourne toujours true.

Toute autre implémentation de cette méthode doit retourner true , sauf en cas d’erreur irrécupérable. Si une erreur irrécupérable se produit, la méthode doit retourner false.

Dans tous les cas où une défaillance se produit, y compris les erreurs non fatales, la méthode doit écrire une entrée détaillée dans le journal des événements pour signaler la raison exacte de l’échec.

Remarques

L’implémentation par défaut de cette méthode par la classe de base CVssWriter retourne true sans effectuer d’autre opération.

Les rédacteurs ne doivent jamais lever d’exception à cette méthode ou à toute autre méthode de rappel CVssWriter(Ex) ::On Xxx .

Les rédacteurs ne doivent jamais appeler la méthode CVssWriter ::SetWriterFailure à partir de la méthode OnIdentify ou CVssWriterEx ::OnIdentifyEx .

Si cette méthode appelle la méthode CVssWriterEx2 ::GetSessionId , elle doit le faire dans le thread qui a appelé cette méthode. Pour plus d’informations, consultez Gestion des événements writer.

En réponse à un événement Identifier généré par une autre application, un enregistreur utilise le gestionnaire OnIdentify pour créer un document de métadonnées de l’enregistreur contenant des informations sur les composants qu’il gère à l’aide de l’interface IVssCreateWriterMetadata .

L’application qui a généré l’événement Identifier récupère ensuite le document de métadonnées de l’enregistreur et examine les informations de composant de l’enregistreur à l’aide de l’interface IVssExamineWriterMetadata .

Un événement Identifier est requis avant les événements qui composent une séquence de sauvegarde ou de restauration. Par conséquent, OnIdentify est peut-être le plus souvent appelé pour gérer un événement Identifier en réponse à l’appel d’un demandeur à IVssBackupComponents ::GatherWriterMetadata dans le cadre d’une opération de sauvegarde ou de restauration.

Toutefois, un événement Identifier ne fait pas lui-même partie de la séquence d’événements qui composent une sauvegarde ou une restauration et le service VSS n’empêche pas sa génération, même lorsqu’une séquence de sauvegarde ou de restauration est en cours. Par instance, les applications de gestion VSS utilisent l’événement Identifier pour déterminer et afficher l’état des enregistreurs sur le système.

Dans ce cas, les rédacteurs ne doivent jamais utiliser leur implémentation d’OnIdentify des manières suivantes :

• Comme le début de leur gestion d’une sauvegarde ou d’une restauration
• Pour définir ou conserver des informations sur l’état de l’enregistreur

Pour plus d’informations sur les interactions de l’auteur avec les événements, consultez Gestion des événements writer.

Le cycle de vie de l’objet IVssCreateWriterMetadata passé dans OnIdentify est géré par l’infrastructure VSS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vswriter.h (inclure Vss.h, VsWriter.h)
Bibliothèque	VssApi.lib

Voir aussi

CVssWriter

IVssBackupComponents ::GatherWriterMetadata

IVssCreateWriterMetadata