Segnalazione degli errori dei componenti della pipeline

I componenti della pipeline segnalano errori in due modi:

• Per i componenti basati su .NET, generando un'eccezione.

• Per i componenti basati su COM, impostando l'oggetto ErrorInfo e restituendo un HRESULT non riuscito.

Segnalazione di errori dai componenti della pipeline .NET

Per segnalare un errore, un componente della pipeline basato su .NET deve generare un'eccezione in cui segnala la descrizione dell'errore. Per segnalare il nome del componente che genera un errore, impostare la proprietà Source dell'oggetto Exception .

Il motore di messaggistica utilizza le proprietà Message e Source dell'oggetto Exception per segnalare un errore. Il messaggio seguente viene scritto nel registro eventi:

"Errore durante l'esecuzione della pipeline [ricezione|invio]: <nome della pipeline> Origine: <Origine> [Percorso di ricezione|Porta di invio:] <nome del percorso|porta> Motivo: <Messaggio>."

Segnalazione di errori dai componenti della pipeline COM

Per segnalare un errore, i componenti della pipeline basati su COM eseguono le azioni seguenti:

1. Il componente della pipeline imposta l'oggetto IErrorInfo chiamando il metodo SetErrorInfo .

2. Il componente della pipeline restituisce un HRESULT non riuscito al motore di messaggistica.

   Il motore di messaggistica usa le proprietà GetSource e GetDescription dell'oggetto IErrorInfo per segnalare un errore. Se l'origine non è impostata, viene usato il nome del componente. Se la descrizione non è impostata o l'intero oggetto ErrorInfo non è impostato, viene restituito HRESULT anziché la descrizione. Il messaggio seguente viene scritto nel registro eventi:

   "C'è stato un errore durante l'esecuzione della pipeline [ricezione|invio]: <nome della pipeline> Origine: <GetSource> [Porta di ricezione|Porta di invio:] <nome della locazione|nome della porta> Motivo: <GetDescription o HRESULT>."

Vedere anche

Sviluppo di componenti della pipeline personalizzati