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

Menentukan panjang data saat ini dalam byte kolom panjang variabel atau kolom yang memungkinkan nilai NULL.

Sintaks

  
int srv_setcollen (  
SRV_PROC *  
srvproc  
,  
int   
column  
,  
int  
len   
);  

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.

column
Menunjukkan jumlah kolom yang panjang datanya ditentukan. Kolom diberi nomor dimulai dengan 1.

Len
Menunjukkan panjang, dalam byte, dari data kolom. Panjang 0 berarti nilai data kolom null.

Mengembalikan

BERHASIL atau GAGAL.

Keterangan

Setiap kolom baris harus terlebih dahulu ditentukan dengan srv_describe. Panjang data kolom diatur oleh panggilan terakhir ke srv_describe atau srv_setcollen. Jika data panjang variabel (data yang dihentikan null) berubah untuk baris, srv_setcollen harus digunakan untuk mengaturnya ke panjang baru sebelum memanggil srv_sendrow. Untuk kolom yang memungkinkan nilai null, srv_describe harus dipanggil dengan desttype diatur ke jenis data yang memungkinkan null (seperti SRVINTN) dan data null ditentukan dengan memanggil srv_setcollen dengan lensa diatur ke 0. Data panjang nol tidak dapat ditentukan menggunakan EXTENDED Stored Procedure API.

Perhatikan bahwa ketika jenis data kolom memiliki panjang variabel, len tidak dicentang. Fungsi ini mengembalikan FAIL jika dipanggil untuk kolom panjang tetap.

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_describe (EXTENDED Stored Procedure API)