sp_addextendedproc (Transact-SQL)

  • Artículo

Se aplica a:SQL Server

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

Nota:

Esta característica se quitará en una versión futura de 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, use la integración con CLR.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @functname = ] N'functname'

Nombre de la función que se va a llamar dentro de la biblioteca de vínculos dinámicos (DLL). @functname es nvarchar(517), sin ningún valor predeterminado. @functname opcionalmente puede incluir el nombre del propietario en el formulario <owner.function>.

[ @dllname = ] 'dllname'

Nombre del archivo DLL que contiene la función . @dllname es varchar(255), sin ningún valor predeterminado. Debe especificar la ruta de acceso completa del archivo DLL.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Ninguno.

Comentarios

Después de crear un procedimiento almacenado extendido, debe agregarse a SQL Server mediante sp_addextendedproc. Para obtener más información, vea Agregar un procedimiento almacenado extendido a SQL Server.

Este procedimiento solo se puede ejecutar en la master base de datos. Para ejecutar un procedimiento almacenado extendido desde una base de datos distinta masterde , califica 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 de sys.extended_procedures .

Importante

Los archivos DLL existentes que no están registrados con una ruta de acceso completa no funcionan después de actualizar a SQL Server. Para corregir el problema, use sp_dropextendedproc para anular el registro del archivo DLL y, a continuación, vuelva a registrarlo con sp_addextendedproc, especificando la ruta de acceso completa.

Permisos

Solo los miembros del rol fijo de servidor sysadmin pueden ejecutar sp_addextendedproc.

Ejemplos

En el ejemplo siguiente se agrega el xp_hello procedimiento almacenado extendido.

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

Contenido relacionado