sp_addextendedproc (Transact-SQL)

S’applique à :SQL Server

Inscrit le nom d’une nouvelle procédure stockée étendue dans SQL Server.

Remarque

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 l’intégration CLR à la place.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_addextendedproc
    [ @functname = ] N'functname'
    , [ @dllname = ] 'dllname'
[ ; ]

Arguments

[ @functname = ] N’functname'

Nom de la fonction à appeler dans la bibliothèque de liens dynamiques (DLL). @functname est nvarchar(517), sans valeur par défaut. @functname éventuellement peut inclure le nom du propriétaire dans le formulaire <owner.function>.

[ @dllname = ] 'dllname'

Nom de la DLL qui contient la fonction. @dllname est varchar(255), sans valeur par défaut. Vous devez spécifier le chemin d’accès complet de la DLL.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu de résultats

Aucune.

Notes

Une fois qu’une procédure stockée étendue est créée, elle doit être ajoutée à SQL Server à l’aide sp_addextendedprocde . 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 master base de données. Pour exécuter une procédure stockée étendue à partir d’une base de données autre que master, qualifiez le nom de la procédure stockée étendue avec master.

sp_addextendedproc ajoute des entrées à l’affichage catalogue sys.objects , en inscrivant le nom de la nouvelle procédure stockée étendue auprès de SQL Server. Il ajoute également une entrée dans l’affichage catalogue sys.extended_procedures .

Important

Les DLL existantes qui ne sont pas inscrites avec un chemin d’accès complet ne fonctionnent pas après la mise à niveau vers SQL Server. Pour corriger le problème, utilisez sp_dropextendedproc pour annuler l’inscription de la DLL, puis réinscrire-la sp_addextendedproc, en spécifiant le chemin d’accès complet.

Autorisations

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

Exemples

L’exemple suivant ajoute la xp_hello procédure stockée étendue.

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