srv_paramname (API Stored procedure estesa)

Importante
Questa caratteristica verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Non utilizzare questa caratteristica in un nuovo progetto di sviluppo e modificare non appena possibile le applicazioni in cui è attualmente implementata. Utilizzare invece la funzionalità di integrazione con CLR.

Restituisce il nome di un parametro di chiamata a una stored procedure remota.

Sintassi

DBCHAR * srv_paramname (
SRV_PROC * srvproc,intn, int *len );

Argomenti

• srvproc
  Puntatore alla struttura SRV_PROC che rappresenta l'handle di una determinata connessione client. In questo caso, l'handle che ha ricevuto la chiamata alla stored procedure remota. La struttura contiene informazioni utilizzate dalla libreria dell'API Stored procedure estesa per gestire le comunicazioni e i dati tra l'applicazione e il client.

• n
  Indica il numero del parametro. Il primo parametro è 1.

• len
  Fornisce un puntatore a una variabile int che contiene la lunghezza, espressa in byte, del nome del parametro. Se len è NULL, la lunghezza del nome del parametro della stored procedure remota non viene restituita.

Restituisce

Puntatore a una stringa di caratteri con terminazione di tipo Null che contiene il nome del parametro. La lunghezza del nome del parametro viene archiviata in len. In assenza di un parametro in posizione n o di una stored procedure remota, restituisce NULL, len viene impostato su -1 e viene inviato un messaggio informativo di errore. Se il nome del parametro è NULL, len viene impostato su 0 e viene restituita una stringa vuota con terminazione di tipo Null.

Osservazioni

Questa funzione ottiene il nome di un parametro di chiamata alla stored procedure remota. Quando una chiamata alla stored procedure remota viene effettuata con i parametri, tali parametri possono essere passati per nome o per posizione (senza nome). Se invece viene effettuata con alcuni parametri passati per nome e altri passati per posizione, si verifica un errore. Il gestore SRV_RPC viene ancora chiamato ma risulta che non sono presenti parametri e srv_rpcparams restituisce 0.

Nota sulla sicurezza
È necessario esaminare con attenzione il codice sorgente delle stored procedure estese e testare le DLL compilate prima di installarle in un server di produzione. Per informazioni sui test e sull'analisi di protezione, visitare questo sito Web Microsoft.

Vedere anche

Riferimento

srv_rpcparams (API delle stored procedure estese)