Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Removes an application role from the current database.
Important
This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Use DROP APPLICATION ROLE instead.
Transact-SQL Syntax Conventions
Syntax
sp_dropapprole [@rolename = ] 'role'
Arguments
- [ @rolename = ] 'role'
Is the application role to remove. role is a sysname, with no default. role must exist in the current database.
Return Code Values
0 (success) or 1 (failure)
Remarks
sp_dropapprole can only be used to remove application roles. If a role owns any securables, the role cannot be dropped. Before dropping an application role that owns securables, you must first transfer ownership of the securables, or drop them.
sp_dropapprole cannot be executed within a user-defined transaction.
Permissions
Requires ALTER ANY APPLICATION ROLE permission on the database.
Examples
The following example removes the SalesApp
application role from the current database.
EXEC sp_dropapprole 'SalesApp'
See Also
Reference
Security Stored Procedures (Transact-SQL)
sp_addapprole (Transact-SQL)
DROP APPLICATION ROLE (Transact-SQL)
sp_changeobjectowner (Transact-SQL)
sp_setapprole (Transact-SQL)
System Stored Procedures (Transact-SQL)