srv_setcoldata (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 l'indirizzo corrente per i dati di una colonna.

Sintassi

  
int srv_setcoldata (  
SRV_PROC *  
srvproc  
,  
int   
column  
,  
void *  
data   
);  

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 il quale viene specificato l'indirizzo. Le colonne sono numerate a partire da 1.

data
Indicatore di misura per i dati di una colonna. La memoria allocata per data non deve essere liberata fino a quando i dati della colonna non vengono sostituiti da un'altra chiamata a srv_setcoldata o fino alla chiamata a srv_senddone.

Valori restituiti

SUCCEED o FAIL.

Osservazioni:

Ogni colonna della riga deve essere definita prima con srv_describe. Gli indirizzi dei dati della colonna sono impostati inizialmente con srv_describe. Se l'indirizzo dei dati della colonna cambia, è necessario chiamare srv_setcoldata per specificare il nuovo indirizzo dei dati e quindi srv_setcoldata separatamente per ogni colonna modificata.

I dati Null vengono rappresentati impostando la lunghezza della colonna su 0 con srv_setcollen. L'indirizzo dei dati viene quindi ignorato.

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)