srv_message_handler (EXTENDED Stored Procedure API)

Berlaku untuk:SQL Server

Penting

Fitur ini akan dihapus dalam versi SQL Server yang akan datang. Hindari menggunakan fitur ini dalam pekerjaan pengembangan baru, dan rencanakan untuk memodifikasi aplikasi yang saat ini menggunakan fitur ini. Gunakan integrasi CLR sebagai gantinya.

Memanggil handler pesan EXTENDED Stored Procedure API yang diinstal. Fungsi ini biasanya digunakan untuk memanggil Microsoft SQL Server dari prosedur tersimpan yang diperluas untuk mencatat kesalahan (ditentukan oleh prosedur tersimpan yang diperluas) dalam file log kesalahan SQL Server atau log aplikasi Microsoft Windows.

Sintaks

  
int srv_message_handler (  
SRV_PROC *  
srvproc  
,  
int  
errornum  
,  
BYTE   
severity  
,  
BYTE  
state  
,  
int  
oserrnum  
,  
char *  
errtext  
,  
int  
errtextlen  
,  
char *  
oserrtext  
,  
int  
oserrtextlen  
);  

Argumen

srvproc
Adalah penunjuk ke struktur SRV_PROC yang merupakan handel untuk koneksi klien tertentu. Parameter srvproc berisi informasi yang digunakan untuk mengelola komunikasi dan data antara aplikasi dan klien.

errornum
Adalah nomor kesalahan yang ditentukan oleh prosedur tersimpan yang diperluas. Jumlah ini harus dari 50.001 hingga 2.147.483.647.

keparahan
Adalah nilai keparahan SQL Server standar untuk kesalahan tersebut. Angka ini harus dari 0 hingga 24.

state
Adalah nilai status SQL Server untuk kesalahan tersebut.

oserrnum
Adalah nomor kesalahan sistem operasi. Argumen ini diabaikan.

errtext
Adalah deskripsi errornum kesalahan prosedur tersimpan yang diperluas.

errtextlen
Adalah panjang string kesalahan prosedur tersimpan yang diperluas errtext.

oserrtext
Adalah deskripsi oserrnum kesalahan sistem operasi. Argumen ini diabaikan.

oserrtextlen
Adalah panjang oserrtext string kesalahan sistem operasi.

Mengembalikan

BERHASIL atau GAGAL.

Keterangan

Fungsi srv_message_handler memungkinkan prosedur tersimpan yang diperluas untuk diintegrasikan dengan fitur pengelogan kesalahan terpusat dan pelaporan SQL Server. Pemberitahuan SQL Server dapat dibuat untuk peristiwa dari prosedur tersimpan yang diperluas, dan SQL Server Agent akan memantau kondisi pemberitahuan ini.

Jika pesan kesalahan lebih panjang, pesan akan dipotong menjadi 412 byte.

Penting

Anda harus meninjau kode sumber prosedur tersimpan yang diperluas secara menyeluruh, dan Anda harus menguji DLL yang dikompilasi sebelum menginstalnya di server produksi. Untuk informasi tentang peninjauan dan pengujian keamanan, lihat situs Web Microsoft ini.