srv_paramsetoutput (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 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 ou la fonction échouera.

Valeurs retournées

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.