sp_addextendedproc (Transact-SQL)

Registra el nombre de un nuevo procedimiento almacenado extendido en MicrosoftSQL Server.

[!NOTA]

Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.En su lugar, utilice la integración CLR.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

  • [ @functname = ] 'procedure'
    Es el nombre de la función a la que ha de llamarse dentro de la biblioteca de vínculos dinámicos (DLL). procedure es de tipo nvarchar(517) y no tiene valor predeterminado. procedure puede incluir, opcionalmente, el nombre del propietario con el formato owner.function.

  • [ @dllname = ] 'dll'
    Es el nombre de la DLL que contiene la función. dll es de tipo varchar(255) y no tiene valor predeterminado.Se recomienda especificar la ruta completa de la DLL.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Ninguno

Notas

Una vez creado un procedimiento almacenado extendido, se debe agregar a SQL Server mediante sp_addextendedproc. Para obtener más información, vea Agregar un procedimiento almacenado extendido a SQL Server.

Este procedimiento sólo se puede ejecutar en la base de datos maestra. Para ejecutar un procedimiento almacenado extendido desde una base de datos que no sea maestra, califique el nombre del procedimiento almacenado extendido con master.

sp_addextendedproc agrega entradas a la vista de catálogo sys.objects, registrando el nombre del nuevo procedimiento almacenado extendido con SQL Server. También agrega una entrada en la vista de catálogo sys.extended_procedures.

Nota importanteImportante

Las DLL existentes que no se registraron con una ruta completa no funcionarán tras una actualización a SQL Server 2008. Para corregir el problema, utilice sp_dropextendedproc a fin de eliminar la DLL del registro y, a continuación, vuelva a registrarla con sp_addextendedproc, especificando la ruta completa.

Permisos

Sólo los miembros de la función fija de servidor sysadmin pueden ejecutar sp_addextendedproc.

Ejemplos

En este ejemplo se agrega el procedimiento almacenado extendido xp_hello.

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