srv_wsendmsg (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 Unicode ke klien.

Sintaks

  
int srv_wsendmsg(SRV_PROC *   
srvproc  
, int   
msgnum  
, int   
severity  
, WCHAR *   
message  
, int   
msglen  
);  

Argumen

srvproc
Adalah penunjuk ke struktur SRV_PROC yang merupakan handel untuk koneksi klien tertentu. Struktur berisi informasi yang digunakan pustaka EXTENDED Stored Procedure API untuk mengelola komunikasi dan data antara aplikasi dan klien.

Msgnum
Adalah nomor pesan 4-byte.

Keparahan
Menentukan tingkat keparahan kesalahan. Tingkat keparahan kurang dari atau sama dengan 10 dianggap sebagai pesan informasi; jika tidak, itu adalah kesalahan.

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

msglen
Menentukan panjang, dalam karakter, pesan.

Mengembalikan

BERHASIL atau GAGAL.

Keterangan

Gunakan fungsi ini untuk mengirim pesan di Unicode. Ini mirip dengan srv_sendmsg, tetapi pesan yang dikirimnya adalah string WCHAR daripada mengetik string DBCHAR. Perhatikan bahwa panjang pesan dilaporkan dalam karakter daripada byte, dan msglen tidak akan pernah sama dengan SRV_NULLTERM.

Fungsi mengembalikan FAIL ketika

• Msglen yang diberikan tidak dalam kisaran 0-32242.

• Msglen yang diberikan adalah 0 tetapi penunjuk pesan adalah NULL.

• Terjadi kesalahan saat mengirim pesan kesalahan melalui jaringan.

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.

Lihat Juga

srv_sendmsg (EXTENDED Stored Procedure API)