Compartilhar via


sp_addextendedproc (Transact-SQL)

Registra o nome de um novo procedimento armazenado estendido no Microsoft SQL Server.

Dica

Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Use Integração CLR.

Aplica-se a: SQL Server (SQL Server 2008 à versão atual).

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

  • [ @functname = ] 'procedure'
    É o nome da função a ser chamada dentro da DLL (biblioteca de vínculo dinâmico). procedure é nvarchar(517), sem padrão. procedure, opcionalmente, pode incluir o nome do proprietário no formato owner.function.

  • [ @dllname = ] 'dll'
    É o nome da DLL que contém a função. dll é varchar(255), sem padrão. É recomendável especificar o caminho completo da DLL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

Depois de criado, o procedimento armazenado estendido deve ser adicionado ao SQL Server usando sp_addextendedproc. Para obter mais informações, consulte Adicionando um procedimento armazenado estendido ao SQL Server.

Esse procedimento pode ser executado somente no banco de dados mestre. Para executar um procedimento armazenado estendido a partir de um banco de dados diferente do mestre, qualifique seu nome com o mestre.

sp_addextendedproc adiciona entradas à exibição de catálogo sys.objects, registrando o nome do novo procedimento armazenado estendido com o SQL Server. Ele também soma uma entrada na exibição de catálogo sys.extended_procedures.

Importante

DLLs existentes que não são registradas com um caminho completo não funcionarão depois da atualização do SQL Server 2014.Para corrigir o problema, use sp_dropextendedproc para cancelar o registro da DLL e registrá-la novamente com sp_addextendedproc, 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 procedimento armazenado estendido xp_hello.

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

Consulte também

Referência

EXECUTE (Transact-SQL)

GRANT (Transact-SQL)

REVOKE (Transact-SQL)

sp_dropextendedproc (Transact-SQL)

sp_helpextendedproc (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)