sp_revokedbaccess (Transact-SQL)
Applies to: SQL Server
Removes a database user from the current database.
Important
This feature will be removed in a future version of SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Use DROP USER instead.
Transact-SQL syntax conventions
Syntax
sp_revokedbaccess [ @name_in_db = ] N'name_in_db'
[ ; ]
Arguments
[ @name_in_db = ] N'name_in_db'
The name of the database user to be removed. @name_in_db is sysname, with no default. @name_in_db can be the name of a server login, a Windows login, or a Windows group, and must exist in the current database. When you specify a Windows login or Windows group, specify the name by which it's known in the database.
Return code values
0
(success) or 1
(failure).
Remarks
When the database user is removed, the permissions and aliases that depend on the user are also removed.
sp_revokedbaccess
can remove only database users from the current database. Before removing a database user that owns objects in the current database, you must either transfer ownership of the objects or drop them from the database. For more information, see ALTER AUTHORIZATION.
sp_revokedbaccess
can't be executed within a user-defined transaction.
Permissions
Requires ALTER ANY USER permission on the database.
Examples
The following example removes the database user mapped to Edmonds\LolanSo
from the current database.
EXEC sp_revokedbaccess 'Edmonds\LolanSo';
GO