Partager via

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

  • Article

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.

Définit la valeur d'un paramètre de retour. Cette fonction remplace la fonction srv_paramset.

Syntaxe

  
int srv_paramsetoutput (  
SRV_PROC *  
srvproc  
,  
int  
n  
,  
BYTE *  
pbData  
,  
ULONG   
cbLen  
,  
BOOL  
fNull   
);

Arguments

srvproc
Handle d’une connexion cliente.

n
Est le nombre ordinal du paramètre à définir. Le premier paramètre est 1.

pbData
Pointeur vers la valeur de données à renvoyer au client en tant que paramètre de retour de procédure.

cbLen
Est la longueur réelle des données à retourner. Si le type de données du paramètre spécifie des valeurs de longueur constante et qu’il n’autorise pas les valeurs NULL (par exemple, srvbit ou srvint1), cbLen est ignoré. La valeur 0 indique des données de longueur nulle si fNull a la valeur FALSE.

fNull
Indicateur spécifiant si la valeur du paramètre de retour est NULL. Attribuez la valeur TRUE à cet indicateur si le paramètre doit avoir la valeur NULL. La valeur par défaut est FALSE. Si fNull a la valeur TRUE, cbLen doit avoir la valeur 0, sinon la fonction échoue.

Retours

Si les informations de paramètre ont été définies avec succès, la valeur SUCCEED est retournée ; sinon, la valeur FAIL est retournée. La valeur FAIL est retournée dans les cas suivants :

  • le paramètre n'est pas un paramètre de retour, ou

  • l’argument cbLen n’est pas valide.

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.