sp_addextendedproc (Transact-SQL)

Inscrit le nom d'une nouvelle procédure stockée étendue dans Microsoft SQL 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.

Conventions 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.

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 Adding an Extended Stored Procedure to 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 2005. 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.

Valeurs des codes renvoyés

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

Ensemble de résultats

Aucun

Exemple

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

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

Voir aussi

Référence

EXECUTE (Transact-SQL)
GRANT (Transact-SQL)
REVOKE (Transact-SQL)
sp_dropextendedproc (Transact-SQL)
sp_helpextendedproc (Transact-SQL)
Procédures stockées système (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005