Compartilhar via


sp_addextendedproc (Transact-SQL)

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

ObservaçãoObservação

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.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

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

  • [ @dllname = ] 'dll'
    É o nome da DLL que contém a função. dll é varchar(255), sem nenhum 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.

Observação importanteImportante

DLLs existentes que não são registradas com um caminho completo não funcionarão depois da atualização do SQL Server 2008. 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'