sp-dropapprole-transact-sql.md

title	sp_dropapprole (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	03/14/2017
ms.prod	sql
ms.prod_service	database-engine
ms.reviewer
ms.technology	system-objects
ms.topic	language-reference
f1_keywords	sp_dropapprole_TSQL sp_dropapprole
dev_langs	TSQL
helpviewer_keywords	sp_dropapprole
ms.assetid	ea1aefe6-8f7d-46e9-a3cb-7b037b393e73
ms.author	vanto
author	VanMSFT

sp_dropapprole (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx-md]

Removes an application role from the current database.

Important

[!INCLUDEssNoteDepFutureAvoid] 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

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)