Partager via

  • Article

sp_addextendedproc (Transact-SQL)

Inscrit le nom d'une nouvelle procédure stockée étendue dans MicrosoftSQL Server.

[!REMARQUE]

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 prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez de préférence l'intégration du CLR.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sp_addextendedproc [ @functname = ] 'procedure' , 
     [ @dllname = ] 'dll'

Arguments

  • [ @functname =] 'procedure'
    Nom de la fonction à appeler dans la bibliothèque de liens dynamique (DLL). L'argument procedure est de type nvarchar(517) et n'a pas de valeur par défaut. Il peut éventuellement inclure le nom du propriétaire sous la forme owner.function.

  • [ @dllname = ] 'dll'
    Nom de la DLL contenant la fonction. L'argument dll est de type varchar(255) et n'a pas de valeur par défaut. Il est recommandé de spécifier le chemin complet d'accès à la DLL.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Ensemble de résultats

Aucun

Notes

Une fois créée, une procédure stockée étendue doit être ajoutée à SQL Server à l'aide de la procédure sp_addextendedproc. Pour plus d'informations, consultez Ajout d'une procédure stockée étendue à SQL Server.

Cette procédure ne peut être exécutée que dans la base de données master. Pour exécuter une procédure stockée étendue à partir d'une base de données autre que master, vous devez qualifier le nom de la procédure stockée étendue avec master.

La procédure sp_addextendedproc ajoute des entrées à la vue de catalogue sys.objects et inscrit le nom de la nouvelle procédure stockée étendue avec SQL Server Elle ajoute également une entrée à la vue de catalogue sys.extended_procedures.

Important

Les DLL existantes qui n'ont pas été inscrites avec leur chemin complet ne fonctionneront plus après une mise à niveau vers SQL Server 2008. Pour corriger ce problème, utilisez sp_dropextendedproc pour annuler l'inscription de la DLL, puis inscrivez-la de nouveau avec la procédure sp_addextendedproc, en spécifiant le chemin complet.

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter sp_addextendedproc.

Exemple

Cet exemple ajoute la procédure stockée étendue xp_hello.

USE master
GO
EXEC sp_addextendedproc xp_hello, 'c:\xp_hello.dll'