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

Article
06/02/2023

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.

Spécifie la longueur de données actuelle, en octets, d'une colonne de longueur variable ou d'une colonne qui autorise des valeurs NULL.

Syntaxe

  
int srv_setcollen (  
SRV_PROC *  
srvproc  
,  
int   
column  
,  
int  
len   
);

Arguments

srvproc
Pointeur vers la structure SRV_PROC qui est le handle pour une connexion cliente particulière. 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.

column
Indique le numéro de la colonne pour laquelle la longueur des données est spécifiée. Les colonnes sont numérotées, en commençant par 1.

len
Indique la longueur, en octets, des données de la colonne. Une longueur de 0 signifie que les données de la colonne sont Null.

Retours

SUCCEED ou FAIL.

Notes

Chaque colonne de la ligne doit être au préalable définie avec srv_describe. La longueur des données de la colonne est définie par le dernier appel à srv_describe ou srv_setcollen. En cas de modification des données de longueur variable (données se terminant par le caractère Null) pour une ligne, vous devez utiliser srv_setcollen pour définir la nouvelle longueur avant d’appeler srv_sendrow. Pour une colonne qui autorise des valeurs Null, srv_describe doit être appelé avec un type de données qui autorise des valeurs Null attribué à desttype (comme SRVINTN) et des données Null sont spécifiées en appelant srv_setcollen avec la valeur 0 attribuée à len. Les données de longueur nulle ne peuvent pas être spécifiées à l'aide de l'API de procédure stockée étendue.

Notez que quand le type de données de la colonne est de longueur variable, len n’est pas vérifié. Cette fonction retourne FAIL si elle est appelée pour une colonne de longueur fixe.

Important

Il est préférable d'examiner avec soin 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

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

Partager via