Condividi tramite

srv_senddone (API delle stored procedure estese)

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

Invia messaggio di completamento dei risultati al client.

Sintassi

  
int srv_senddone (  
SRV_PROC *  
srvproc  
,  
DBUSMALLINT   
status  
,  
DBUSMALLINT  
info  
,  
DBINT  
count   
);

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 richiesta del linguaggio. 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.

status
Campo a 2 byte per vari flag di status. È possibile impostare più flag usando gli operatori logici AND e OR con i valori dei flag di status. Nella tabella seguente sono elencati i possibili flag di status.

Flag di stato Descrizione
SRV_DONE_COUNT Il parametro count contiene un conteggio valido.
SRV_DONE_ERROR Il comando client corrente ha ricevuto un errore.

info
Campo a 2 byte riservato. Impostare questo valore su 0.

count
Campo a 4 byte utilizzato per indicare un conteggio per il set di risultati corrente. Se il flag SRV_DONE_COUNT è impostato nel campo status, count include un conteggio valido.

Valori restituiti

SUCCEED o FAIL

Osservazioni:

Una richiesta del client può provocare l'esecuzione da parte del server di alcuni comandi e la restituzione di alcuni set di risultati. Per ogni set di risultati, srv_senddone deve restituire un messaggio di completamento dei risultati al client.

Il campo count indica il numero di righe interessate da un comando. Se il campo count contiene un conteggio, il flag SRV_DONE_COUNT deve essere impostato nel campo status. Questa impostazione consente al client di distinguere tra un valore di count pari a 0 e un campo count inutilizzato.

Non chiamare srv_senddone dal gestore SRV_CONNECT.

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.