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

Article
03/12/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.

Retourne des informations sur un paramètre. Cette fonction remplace les fonctions suivantes : srv_paramtype, srv_paramlen, srv_parammaxlen et srv_paramdata. srv_paraminfo prend en charge les types de données dans Data Types et les données de longueur nulle.

Syntaxe

  
int srv_paraminfo (  
SRV_PROC *  
srvproc  
,  
int  
n  
,  
BYTE *  
pbType  
,  
ULONG *  
pcbMaxLen  
,  
ULONG *  
pcbActualLen  
,  
BYTE *  
pbData  
,  
BOOL *  
pfNull  
);

Arguments

srvproc
Handle d'une connexion cliente.

n
Nombre ordinal du paramètre à définir. Le premier paramètre est 1.

pbType
Type de données du paramètre.

pcbMaxLen
Pointeur vers la longueur maximale du paramètre.

pcbActualLen
Pointeur vers la longueur réelle du paramètre. La valeur 0 (*ccpActualLen == 0) signifie que les données de longueur zéro si *pfNull a la valeur FALSE.

pbData
Pointeur vers la mémoire tampon des données de paramètre. Si pbData n’est pas NULL, l’API de procédure store étendue écrit *pbData en octets *pbData* octets de données. Si pbData a la valeur NULL, aucune donnée n’est écrite dans *pbData , mais la fonction retourne *pbType, *pbMaxLen, *ccpActualLen et *pfNull. Cette mémoire tampon doit être gérée par l'application.

pfNull
Pointeur vers un indicateur null. *pfNull a la valeur TRUE si la valeur du paramètre est NULL.

Retours

Si les informations sur le paramètre ont été obtenues avec succès, la valeur SUCCEED est retournée ; sinon, FAIL. La valeur FAIL est retournée en l’absence de procédure stockée distante active ou en l’absence d’un nième paramètre de procédure stockée.

Notes

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

Guide de référence du programmeur sur les procédures stockées étendues

Partager via