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 plutôt l’intégration clR (Common Language Runtime).
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) or 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_addextendedproc
de . 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';