srv_senddone (EXTENDED Stored Procedure API)

Artikel
03/12/2024

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 penyelesaian hasil ke klien.

Sintaks

  
int srv_senddone (  
SRV_PROC *  
srvproc  
,  
DBUSMALLINT   
status  
,  
DBUSMALLINT  
info  
,  
DBINT  
count   
);

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.

status
Adalah bidang 2-byte untuk berbagai bendera status . Beberapa bendera dapat diatur dengan menggunakan operator logis AND dan OR dengan nilai bendera status . Tabel berikut ini mencantumkan kemungkinan bendera status .

Bendera status	Deskripsi
SRV_DONE_COUNT	Parameter hitungan berisi jumlah yang valid.
SRV_DONE_ERROR	Perintah klien saat ini menerima kesalahan.

info
Adalah bidang 2 byte yang dicadangkan. Atur nilai ini ke 0.

count
Adalah bidang 4-byte yang digunakan untuk menunjukkan hitungan untuk kumpulan hasil saat ini. Jika bendera SRV_DONE_COUNT diatur di bidang status , hitungan akan menyimpan jumlah yang valid.

Mengembalikan

BERHASIL atau GAGAL

Keterangan

Permintaan klien dapat menyebabkan server menjalankan sejumlah perintah dan mengembalikan sejumlah kumpulan hasil. Untuk setiap tataan hasil, srv_senddone harus mengembalikan pesan penyelesaian hasil kepada klien.

Bidang hitungan menunjukkan jumlah baris yang dipengaruhi oleh perintah. Jika bidang hitungan berisi hitungan, bendera SRV_DONE_COUNT harus diatur di bidang status. Pengaturan ini memungkinkan klien untuk membedakan antara nilai hitungan 0 dan bidang hitungan yang tidak digunakan.

Jangan panggil srv_senddone dari handler SRV_CONNECT.

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.

Bagikan melalui