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: