Signalement d’erreurs par les composants de pipeline

Les composants de pipeline signalent les erreurs de deux manières :

• Pour les composants .NET, en levant une exception.

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

Signalement des erreurs par les composants de pipeline .NET

Pour signaler une erreur, un composant de pipeline .NET doit lever une exception à l'emplacement où il signale 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 :

« Échec de l’exécution du pipeline [receive|send] : <nom> du pipeline Source : <Source> [Emplacement de réception|Send Port :] <location|port name> Reason : <Message>. »

Signalement d'erreurs par les composants de pipeline COM

Pou 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. Il retourne une valeur HRESULT d'échec au 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’objet ErrorInfo entier 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 :

   « Échec de l’exécution du pipeline [receive|send] : <nom> du pipeline Source : <GetSource> [Emplacement de réception|Send Port :] <location|port name> Reason : <GetDescription or HRESULT>. »

Voir aussi

Développement des composants de pipeline personnalisés