sp_addextendedproc (Transact-SQL)
Aplica-se: SQL Server
Registra o nome de um novo procedimento armazenado estendido no SQL Server.
Observação
Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Em vez disso, use a integração CLR (Common Language Runtime).
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_addextendedproc
[ @functname = ] N'functname'
, [ @dllname = ] 'dllname'
[ ; ]
Argumentos
@functname [ = ] N'functname'
O nome da função a ser chamada na DLL (biblioteca de vínculo dinâmico). @functname é nvarchar(517), sem padrão. @functname opcionalmente pode incluir o nome do proprietário no formulário <owner.function>
.
@dllname [ = ] 'dllname'
O nome da DLL que contém a função. @dllname é varchar(255), sem padrão. Você deve especificar o caminho completo da DLL.
Valores do código de retorno
0
(sucesso) ou 1
(falha).
Conjunto de resultados
Nenhum.
Comentários
Depois que um procedimento armazenado estendido é criado, ele deve ser adicionado ao SQL Server usando sp_addextendedproc
o . Para obter mais informações, consulte Adicionando um procedimento armazenado estendido ao SQL Server.
Esse procedimento só pode ser executado no master
banco de dados. Para executar um procedimento armazenado estendido de um banco de dados diferente master
de , qualifique o nome do procedimento armazenado estendido com master
.
sp_addextendedproc
adiciona entradas à exibição do catálogo sys.objects , registrando o nome do novo procedimento armazenado estendido com o SQL Server. Ele também adiciona uma entrada na exibição de catálogo sys.extended_procedures .
Importante
As DLLs existentes que não estão registradas com um caminho completo não funcionam após a atualização para o SQL Server. Para corrigir o problema, use sp_dropextendedproc
para cancelar o registro da DLL e, em seguida, registre-a novamente com sp_addextendedproc
o , especificando o caminho completo.
Permissões
Somente membros da função de servidor fixa sysadmin podem executar sp_addextendedproc
.
Exemplos
O exemplo a seguir adiciona o xp_hello
procedimento armazenado estendido.
USE master;
GO
EXEC sp_addextendedproc xp_hello, 'c:\xp_hello.dll';