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

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 utilizzare 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.

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