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

Important

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et modifiez dès que possible les applications qui utilisent actuellement cette fonctionnalité. Use CLR integration instead.

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.

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

Valeur renvoyée

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.

Remarque relative à la sécurité
Il est recommandé de revoir en détail le code source des procédures stockées étendues et de tester les DLL compilées avant de les installer sur un serveur de production. Pour plus d'informations sur l'examen et les tests de sécurité, consultez ce site Web de Microsoft.