sp_addextendedproc (Transact-SQL)

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

Observaçã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.

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 2012. 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)