Partilhar via


sp_dropapprole (Transact-SQL)

Aplica-se: SQL Server

Remove uma função de aplicativo do banco de dados atual.

Importante

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 DROP APPLICATION ROLE .

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_dropapprole [ @rolename = ] N'rolename'
[ ; ]

Argumentos

@rolename [ = ] N'nome da função'

A função do aplicativo a ser removida. @rolename é sysname, sem padrão. @rolename deve existir no banco de dados atual.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_dropapprole só pode ser usado para remover funções de aplicativo. Se uma função possuir protegíveis, a função não poderá ser descartada. Antes de descartar uma função de aplicativo que possui itens protegíveis, é necessário transferir a propriedade dos itens protegíveis primeiro ou descartá-los.

sp_dropapprole não pode ser executado em uma transação definida pelo usuário.

Permissões

Requer a permissão ALTER ANY APPLICATION ROLE no banco de dados.

Exemplos

O exemplo a seguir remove a função de aplicativo SalesApp do banco de dados atual.

EXEC sp_dropapprole 'SalesApp';