srv_setcollen (API Stored procedure estesa)
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.