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

Mengembalikan nilai parameter panggilan prosedur tersimpan jarak jauh. Fungsi ini telah digantikan oleh fungsi srv_paraminfo .

Sintaks

  
void * srv_paramdata (  
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 Prosedur Tersimpan yang Diperluas untuk mengelola komunikasi dan data antara aplikasi dan klien.

n
Adalah jumlah parameter. Parameter pertama adalah nomor 1.

Mengembalikan

Penunjuk ke nilai parameter. Jika parameter nth adalah NULL, tidak ada parameter nth, atau tidak ada prosedur tersimpan jarak jauh, mengembalikan NULL. Jika nilai parameter adalah string, nilai tersebut mungkin tidak dihentikan null. Gunakan srv_paramlen untuk menentukan panjang string.

Fungsi ini mengembalikan nilai berikut, jika parameter adalah salah satu jenis data Microsoft SQL Server. Data penunjuk mencakup apakah penunjuk untuk jenis data valid (VP), NULL, atau tidak berlaku (N/A), dan konten data yang ditujukkan.

Jenis data baru	Panjang data input
BITN	NULL: VP, NULL NOL: VP, NULL >=255: N/A <255: N/A
BIGVARCHAR	NULL: NULL, N/A NOL: VP, NULL >=255: VP, 255 karakter <255: VP, data aktual
BIGCHAR	NULL: NULL, N/A NOL: VP, 255 spasi >=255: VP, 255 karakter <255: VP, data aktual + padding (hingga 255)
BIGBINARY	NULL: NULL, N/A NOL: VP, 255 0x00 >=255: VP, 255 byte <255: VP, data aktual + padding (hingga 255)
BIGVARBINARY	NULL: NULL, N/A NOL: VP, 0x00 >=255: VP, 255 byte <255: VP, data aktual
NCHAR	NULL: NULL, N/A NOL: VP, 255 spasi >=255: VP, 255 karakter <255: VP, data aktual + padding (hingga 255)
NVARCHAR	NULL: NULL, N/A NOL: VP, NULL >=255: VP, 255 karakter <255: VP, data aktual
NTEXT	NULL: N/A NOL: N/A >=255: N/A <255: N/A

* data tidak dihentikan null; tidak ada peringatan yang dikeluarkan pada pemotongan untuk data >255 karakter.

Keterangan

Jika Anda mengetahui nama parameter, Anda dapat menggunakan srv_paramnumber untuk mendapatkan nomor parameter. Untuk menentukan apakah parameter adalah NULL, gunakan srv_paramlen.

Ketika panggilan prosedur tersimpan jarak jauh dilakukan dengan parameter, parameter dapat diteruskan 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. Jika terjadi kesalahan, 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_rpcparams (EXTENDED Stored Procedure API)