srv_senddone (API de procédure stockée étendue)

Article
03/13/2024

S’applique à :SQL Server

Important

Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez plutôt l'intégration du CLR.

Envoie un message d'achèvement de résultat au client.

Syntaxe

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

Arguments

srvproc
Pointeur vers la structure SRV_PROC qui est le handle d'une connexion cliente particulière (dans ce cas, le handle qui a reçu la demande de langue). La structure contient des informations que la bibliothèque d'API de procédure stockée étendue utilise pour gérer les communications et les données entre l'application et le client.

statut
Champ de deux octets pour différents indicateurs status . Vous pouvez définir plusieurs indicateurs à l'aide des opérateurs logiques AND et OR avec des valeurs d'indicateur status . Le tableau suivant répertorie les indicateurs status possibles.

Indicateur d'état	Description
SRV_DONE_COUNT	Le paramètre count contient un nombre valide.
SRV_DONE_ERROR	La commande cliente actuelle a reçu une erreur.

info
Champ réservé de deux octets. Attribuez à ce champ la valeur 0.

count
Champ de quatre octets utilisé pour indiquer un nombre pour le jeu de résultats actuel. Si l'indicateur SRV_DONE_COUNT est défini dans le champ status , count contient un nombre valide.

Retours

SUCCEED ou FAIL

Notes

Une requête du client peut faire en sorte que le serveur exécute plusieurs commandes et retourne plusieurs jeux de résultats. Pour chaque jeu de résultats, srv_senddone doit retourner un message d'achèvement de résultat au client.

Le champ count indique le nombre de lignes affectées par une commande. Si le champ count contient un nombre, l'indicateur SRV_DONE_COUNT doit être défini dans le champ status . Ce paramètre permet au client d'effectuer la distinction entre une valeur count de 0 et un champ count inutilisé.

N'appelez pas srv_senddone à partir du gestionnaire SRV_CONNECT.