Share via

  • Article

srv_paramname (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.

Retourne le nom d'un paramètre d'appel de procédure stockée distante.

Syntaxe

DBCHAR * srv_paramname (
SRV_PROC * srvproc,intn, int *len );

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 l'appel de procédure stockée distante). 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.

  • n
    Indique le numéro du paramètre. Le premier paramètre est 1.

  • len
    Fournit un pointeur vers une variable int qui contient la longueur, en octets, du nom de paramètre. Si len est NULL, la longueur du nom de paramètre de procédure stockée distante n'est pas retournée.

Valeur renvoyée

Pointeur vers une chaîne de caractères terminée par le caractère NULL qui contient le nom du paramètre. La longueur du nom de paramètre est stockée dans len. S'il n'y a aucun nième paramètre ou aucune procédure stockée distante, la valeur NULL est retournée, la valeur -1 est affectée à len et un message d'erreur informative est envoyé. Si le nom de paramètre est NULL, la valeur 0 est affectée à len et une chaîne vide se terminant par NULL est retournée.

Notes

Cette fonction obtient le nom d'un paramètre d'appel de procédure stockée distante. Lorsqu'un appel de procédure stockée distante est effectué avec des paramètres, ceux-ci peuvent être passés par nom ou par position (sans nom). Si l'appel de procédure stockée distante est effectué avec certains paramètres passés par nom et certains passés par position, une erreur se produit. Le gestionnaire SRV_RPC est tout de même appelé, mais il semble qu'il n'y ait aucun paramètre et srv_rpcparams retourne 0.

Remarque relative à la sécurité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.