sys.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. Use DROP APPLICATION ROLE em seu lugar.

Convenções de sintaxe de Transact-SQL

Sintaxe

sys.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.

EXECUTE sp_dropapprole 'SalesApp';