Melaporkan Kesalahan dari Komponen Alur

Komponen alur melaporkan kesalahan dengan dua cara:

• Untuk komponen berbasis .NET, dengan melemparkan pengecualian.

• Untuk komponen berbasis COM, dengan mengatur objek ErrorInfo dan mengembalikan kegagalan HRESULT.

Melaporkan kesalahan dari komponen alur .NET

Untuk melaporkan kesalahan, komponen pipeline berbasis .NET perlu melempar pengecualian yang akan melaporkan deskripsi kesalahan tersebut. Untuk melaporkan nama komponen yang melempar kesalahan, atur properti Sumber objek Pengecualian .

Mesin Olahpesan menggunakan properti Pesan dan Sumber dari objek Pengecualian untuk melaporkan kesalahan. Pesan berikut ditulis ke log peristiwa:

"Ada kegagalan menjalankan alur [terima|kirim]: <nama alur> Sumber: <Sumber> [Lokasi Penerimaan|Kirim Port:] <nama lokasi|nama port> Alasan: <Pesan>."

Melaporkan kesalahan dari komponen alur COM

Untuk melaporkan kesalahan, komponen alur berbasis COM melakukan tindakan berikut:

1. Komponen alur mengatur objek IErrorInfo dengan memanggil metode SetErrorInfo .

2. Komponen alur mengembalikan HRESULT yang gagal ke Mesin Olahpesan.

   Mesin Olahpesan menggunakan properti GetSource dan GetDescription objek IErrorInfo untuk melaporkan kesalahan. Jika sumber tidak diatur, nama komponen digunakan. Jika deskripsi tidak diatur atau seluruh objek ErrorInfo tidak diatur, HRESULT yang dikembalikan dilaporkan alih-alih deskripsi. Pesan berikut ditulis ke log peristiwa:

   "Ada kegagalan saat menjalankan alur [receive|send]: <pipeline name> Source: <GetSource> [Receive Location|Kirim Port:] <lokasi|nama> port Alasan: <GetDescription atau HRESULT>."

Lihat Juga

Mengembangkan Komponen Alur Kustom