Compartilhar via


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_addextendedproco . 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 masterde , 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_addextendedproco , 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';