srv_parammaxlen (EXTENDED Stored Procedure API)

Artikel
05/30/2023

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.

Mengembalikan panjang data maksimum parameter panggilan prosedur tersimpan jarak jauh. Fungsi ini telah digantikan oleh fungsi srv_paraminfo .

Sintaks

  
int srv_parammaxlen (  
SRV_PROC *  
srvproc  
,  
int  
n   
);

Argumen

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

n
Menunjukkan jumlah parameter. Parameter pertama adalah 1.

Mengembalikan

Panjang maksimum, dalam byte, dari data parameter. Jika tidak ada parameter nth atau jika tidak ada prosedur tersimpan jarak jauh, parameter tersebut mengembalikan -1.

Fungsi ini mengembalikan nilai berikut, jika parameter adalah salah satu jenis data Microsoft SQL Server berikut.

Jenis data baru	Panjang data input
BITN	NULL: 1 NOL: 1 >=255: N/A <255: N/A
BIGVARCHAR	NULL: 255 NOL: 255 >=255: 255 <255: 255
BIGCHAR	NULL: 255 NOL: 255 >=255: 255 <255: 255
BIGBINARY	NULL: 255 NOL: 255 >=255: 255 <255: 255
BIGVARBINARY	NULL: 255 NOL: 255 >=255: 255 <255: 255
NCHAR	NULL: 255 NOL: 255 >=255: 255 <255: 255
NVARCHAR	NULL: 255 NOL: 255 >=255: 255 <255: 255
NTEXT	NULL: -1 NOL: -1 >=255: -1 <255: -1

Keterangan

Setiap parameter prosedur tersimpan jarak jauh memiliki panjang data aktual dan maksimum. Untuk jenis data panjang tetap standar yang tidak mengizinkan nilai null, panjang aktual dan maksimumnya sama. Untuk jenis data dengan panjang variabel, panjangnya dapat bervariasi. Misalnya, parameter yang dinyatakan sebagai varchar(30) dapat memiliki data yang panjangnya hanya 10 byte. Panjang aktual parameter adalah 10 dan panjang maksimumnya adalah 30. Fungsi srv_parammaxlen mendapatkan panjang data maksimum dari prosedur tersimpan jarak jauh. Untuk mendapatkan panjang parameter yang sebenarnya, gunakan srv_paramlen.

Ketika panggilan prosedur tersimpan jarak jauh dilakukan dengan parameter, parameter dapat diteruskan baik berdasarkan nama atau berdasarkan posisi (tidak disebutkan namanya). Jika panggilan prosedur tersimpan jarak jauh dilakukan dengan beberapa parameter yang diteruskan oleh nama dan beberapa diteruskan oleh posisi, kesalahan terjadi. Handler SRV_RPC masih dipanggil, tetapi muncul seolah-olah tidak ada parameter, dan srv_rpcparams mengembalikan 0.

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

Bagikan melalui