Rapport des erreurs des composants de pipeline

Les composants de pipeline signalent des erreurs de deux façons :

• Pour les composants basés sur .NET, en levant une exception.

• Pour les composants COM, en définissant l’objet ErrorInfo et en retournant un HRESULT indiquant un échec.

Rapport des erreurs des composants de pipeline .NET

Pour signaler une erreur, un composant de pipeline basé sur .NET doit lever une exception qui rapporte la description de l'erreur. Pour signaler le nom du composant qui lève une erreur, définissez la propriété Source de l’objet Exception .

Le moteur de messagerie utilise les propriétés Message et Source de l’objet Exception pour signaler une erreur. Le message suivant est écrit dans le journal des événements :

« Un échec s’est produit lors de l’exécution du pipeline [recevoir|envoyer] : <nom du pipeline> Source : <Source> [Emplacement de réception|Point d'envoi :] <nom de l'emplacement|du port> Raison : <Message>. »

Rapport d'erreurs des composants du pipeline COM

Pour signaler une erreur, les composants de pipeline COM effectuent les actions suivantes :

1. Le composant de pipeline définit l’objet IErrorInfo en appelant la méthode SetErrorInfo .

2. Le composant de pipeline retourne un HRESULT ayant échoué dans le moteur de messagerie.

   Le moteur de messagerie utilise les propriétés GetSource et GetDescription de l’objet IErrorInfo pour signaler une erreur. Si la source n’est pas définie, le nom du composant est utilisé. Si la description n’est pas définie ou si l’ensemble de l’objet ErrorInfo n’est pas défini, le HRESULT retourné est signalé au lieu de la description. Le message suivant est écrit dans le journal des événements :

   « Un échec s’est produit lors de l’exécution du pipeline [réception|émission] : <nom du pipeline> Source : <GetSource> [Emplacement de réception|Port d'envoi :] <nom de l'emplacement|du port> Raison : <GetDescription ou HRESULT>. »

Voir aussi

Développement de composants de pipeline personnalisés