srv_sendmsg (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.

Mengirim pesan ke klien.

Sintaks

  
int srv_sendmsg (  
SRV_PROC *  
srvproc  
,  
int  
msgtype  
,  
DBINT  
msgnum  
,  
DBTINYINT  
class  
,   
DBTINYINT  
state  
,  
DBCHAR *  
rpcname  
,  
int   
rpcnamelen  
,  
DBUSMALLINT  
linenum  
,  
DBCHAR *  
message  
,  
int  
msglen   
);  

Argumen

srvproc
Adalah penunjuk ke struktur SRV_PROC yang merupakan handel untuk koneksi klien tertentu (dalam hal ini, handel yang menerima permintaan bahasa). Struktur berisi informasi yang digunakan pustaka EXTENDED Stored Procedure API untuk mengelola komunikasi dan data antara aplikasi dan klien.

msgtype
Apakah SRV_MSG_INFO atau SRV_MSG_ERROR, tergantung pada apakah server mengirim pesan informasi atau kesalahan.

msgnum
Adalah nomor pesan 4-byte.

kelas
Menentukan tingkat keparahan kesalahan. Tingkat keparahan kurang dari atau sama dengan 10 dianggap sebagai pesan informasi.

state
Menyediakan nomor status kesalahan untuk pesan saat ini. Nomor status kesalahan menyediakan informasi tentang konteks kesalahan. Nomor status yang valid adalah dari 0 hingga 255.

rpcname
Saat ini tidak didukung.

rpcnamelen
Saat ini tidak didukung.

linenum
Adalah nomor baris dalam batch perintah bahasa tempat pesan diterapkan. Nomor baris dimulai dari 1. Jika linenum tidak berlaku untuk pesan, atur ke 0.

message
Adalah penunjuk ke string karakter yang akan dikirim ke klien.

msglen
Menentukan panjang, dalam byte, pesan. Jika pesan dihentikan null, atur msglen ke SRV_NULLTERM.

Mengembalikan

BERHASIL atau GAGAL

Keterangan

Fungsi ini mengirimkan pesan kesalahan atau informasi ke klien. Ini dipanggil sekali untuk setiap pesan dikirim.

Pesan dapat dikirim ke klien dengan srv_sendmsg dalam urutan apa pun sebelum atau sesudah semua baris (jika ada) telah dikirim dengan srv_sendrow. Semua pesan, jika ada, harus dikirim ke klien sebelum status penyelesaian dikirim dengan srv_senddone.

Untuk mengirim pesan di Unicode, gunakan srv_wsendmsg daripada srv_sendmsg.

Untuk informasi selengkapnya, lihat Data Unicode dan Halaman Kode Server.

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.