Partager via


srv_setcoldata (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.

Spécifie l'adresse actuelle pour les données d'une colonne.

Syntaxe


int srv_setcoldata (
SRV_PROC *
srvproc
,
int 
column
,
void *
data 
);

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 l'adresse est spécifiée. Les colonnes sont numérotées, en commençant par 1.

  • data
    Pointeur pour les données d'une colonne. La mémoire allouée pour data ne doit pas être libérée tant que les données de la colonne ne sont pas remplacées par un autre appel à srv_setcoldata ou tant que srv_senddone n'est pas appelé.

Valeurs retournées

SUCCEED ou FAIL.

Notes

Chaque colonne de la ligne doit être au préalable définie avec srv_describe. Les adresses des données de colonne sont définies initialement avec srv_describe. En cas de modification de l'adresse des données de colonne, srv_setcoldata doit être appelé pour spécifier la nouvelle adresse des données et srv_setcoldata doit être appelé séparément pour chaque colonne modifiée.

Pour représenter des données Null, attribuez la valeur 0 à la longueur de la colonne avec srv_setcollen. L'adresse des données est alors ignorée.

Remarque relative à la sécurité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.