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

Article
05/07/2013

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 du CLR.

Retourne la valeur d'un paramètre d'appel de procédure stockée distante. Cette fonction a été remplacée par la fonction srv_paraminfo.

Syntaxe

void * srv_paramdata ( 
SRV_PROC * 
srvproc 
, 
int 
n  
);

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 de procédure stockée étendue utilise pour gérer les communications et les données entre l'application et le client.
n
Numéro du paramètre. Le premier paramètre est le numéro 1.

Valeurs retournées

Pointeur vers la valeur de paramètre. Si le nième paramètre a la valeur NULL ou qu'il n'existe pas de nième paramètre ni de procédure stockée distante, la valeur NULL est retournée. Si la valeur de paramètre est une chaîne, elle peut ne pas se terminer par le caractère NULL. Utilisez srv_paramlen pour déterminer la longueur de la chaîne.

Cette fonction retourne les valeurs suivantes, si le paramètre est l'un des types de données Microsoft SQL Server. Les données du pointeur indiquent si le pointeur pour le type de données est valide (VP), NULL ou non applicable (N/A), et le contenu des données désignées par le pointeur.

Nouveaux types de données	Longueur de données d'entrée
BITN	NULL : VP, NULL ZERO : VP, NULL >=255 : N/A <255 : N/A
BIGVARCHAR	NULL : NULL, N/A ZERO : VP, NULL >=255 : VP, 255 caractères <255 : VP, données réelles
BIGCHAR	NULL : NULL, N/A ZERO : VP, 255 espaces >=255 : VP, 255 caractères <255 : VP, données réelles + remplissage (jusqu'à 255)
BIGBINARY	NULL : NULL, N/A ZERO : VP, 255 0x00 >=255 : VP, 255 octets <255 : VP, données réelles + remplissage (jusqu'à 255)
BIGVARBINARY	NULL : NULL, N/A ZERO : VP, 0x00 >=255 : VP, 255 octets <255 : VP, données réelles
NCHAR	NULL : NULL, N/A ZERO : VP, 255 espaces >=255 : VP, 255 caractères <255 : VP, données réelles + remplissage (jusqu'à 255)
NVARCHAR	NULL : NULL, N/A ZERO : VP, NULL >=255 : VP, 255 caractères <255 : VP, données réelles
NTEXT	NULL : N/A ZERO : N/A >=255 : N/A <255 : N/A

* Les données ne se terminent pas par le caractère NULL ; aucun avertissement n'est émis en cas de troncation de données >255 caractères.

Notes

Si vous connaissez le nom du paramètre, vous pouvez utiliser srv_paramnumber pour obtenir le numéro du paramètre. Pour déterminer si un paramètre est NULL, utilisez srv_paramlen.

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. Si une erreur se produit, le gestionnaire SRV_RPC est tout de même appelé, mais il apparaît comme s'il n'y avait aucun paramètre et srv_rpcparams retourne 0.

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.

Voir aussi

Référence

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

Share via