srv_setcollen (API Stored procedure estesa)

  • Articolo

Si applica a:SQL Server

Importante

Questa funzionalità verrà rimossa nelle versioni future di SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Usare invece l'integrazione CLR.

Specifica la lunghezza in byte della data corrente di una colonna a lunghezza variabile o di una colonna che consente valori Null.

Sintassi

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

Argomenti

srvproc
Puntatore alla struttura SRV_PROC che rappresenta l'handle di una determinata connessione client. 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.

column
Indica il numero della colonna per la quale viene specificata la lunghezza dei dati. Le colonne sono numerate a partire da 1.

len
Indica la lunghezza in byte dei dati della colonna. Alla lunghezza 0 corrisponde un valore Null per i dati della colonna.

Valori restituiti

SUCCEED o FAIL.

Osservazioni:

Ogni colonna della riga deve essere definita prima con srv_describe. La lunghezza della colonna dei dati viene impostata dall'ultima chiamata a srv_describe o srv_setcollen. Se viene modificata una riga dei dati a lunghezza variabile (dati con terminazione null), è necessario usare srv_setcollen per impostarli sulla nuova lunghezza prima di chiamare srv_sendrow. Per una colonna che consente valori Null è necessario che sia stato chiamato srv_describe con desttype impostato su un tipo di dati che consente valori Null (ad esempio SRVINTN) e che i dati Null siano stati specificati chiamando srv_setcollen con len impostato su 0. Quando si utilizza l'API Stored procedure estesa, non è possibile specificare dati di lunghezza zero.

Quando il tipo di dati della colonna è a lunghezza variabile, len non viene controllato. Questa funzione restituisce FAIL se chiamata per una colonna a lunghezza fissa.

Importante

È 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 della sicurezza, visitare questo sito Web Microsoft.

Vedi anche

srv_describe (API Stored procedure estesa)