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é. Utilisez plutôt l'intégration 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 pour 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. |