Partilhar via

  • Artigo

sp_addextendedproc (Transact-SQL)

Registra o nome de um novo procedimento armazenado estendido no MicrosoftSQL 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'