Revoke Method (Database)

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.

The Revoke method undoes a grant or deny of database permissions for one or more Microsoft SQL Server users or roles.

Syntax

object
.Revoke(
Privilege
,
GranteeNames
)

Parts

• object
  Expression that evaluates to an object in the Applies To list.

• Privilege
  Long integer that specifies one or more database permissions as described in Settings.

• GranteeNames
  SQL Distributed Management Objects (SQL-DMO) multi-string that lists users or roles.

Prototype (C/C++)

HRESULT Revoke(
SQLDMO_PRIVILEGE_TYPE iPrivileges,
SQLDMO_LPCSTR GranteeNames);

Settings

Set Privilege by using these SQLDMO_PRIVILEGE_TYPE values. To specify more than a single permission, combine values by using an OR logical operator.

Constant	Value	Description
SQLDMOPriv_/AllDatabasePrivs	130944	Revoke all granted or denied database permissions.
SQLDMOPriv_CreateDatabase	256	Revoke granted or denied permission to execute a CREATE DATABASE statement.
SQLDMOPriv_CreateDefault	4096	Revoke granted or denied permission to execute a CREATE DEFAULT statement.
SQLDMOPriv_CreateFunction	65366	Revoke granted or denied permission to execute a CREATE FUNCTION statement.
SQLDMOPriv_CreateProcedure	1024	Revoke granted or denied permission to execute a CREATE PROCEDURE statement.
SQLDMOPriv_CreateRule	16384	Revoke granted or denied permission to execute a CREATE RULE statement.
SQLDMOPriv_CreateTable	128	Revoke granted or denied permission to execute a CREATE TABLE statement.
SQLDMOPriv_CreateView	512	Revoke granted or denied permission to execute a CREATE VIEW statement.
SQLDMOPriv_DumpDatabase	2048	Revoke granted or denied permission to back up the database.
SQLDMOPriv_DumpTable	32768	Maintained for compatibility with previous versions of SQL-DMO.
SQLDMOPriv_/DumpTransaction	8192	Revoke granted or denied permission to back up the database transaction log.

Remarks

Revoking granted or denied permissions to database users and roles by using the Revoke method of the Database object requires appropriate permission. The Microsoft SQL Server login used for SQLServer object connection must be a member of the system-defined role sysadmin.

For more information about setting multistring parameters, see Using SQL-DMO Multistrings.

Applies To:

Database Object