Skip to content

Latest commit

 

History

History
74 lines (57 loc) · 2.93 KB

File metadata and controls

74 lines (57 loc) · 2.93 KB
title sp_denylogin (Transact-SQL) | Microsoft Docs
ms.custom
ms.date 03/14/2017
ms.prod sql-non-specified
ms.reviewer
ms.suite
ms.technology
database-engine
ms.tgt_pltfrm
ms.topic language-reference
f1_keywords
sp_denylogin_TSQL
sp_denylogin
dev_langs
TSQL
helpviewer_keywords
sp_denylogin
ms.assetid db80f152-e8af-4303-95b6-3a3a7b664374
caps.latest.revision 31
author BYHAM
ms.author rickbyh
manager jhubbard

sp_denylogin (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx_md]

Prevents a Windows user or Windows group from connecting to an instance of [!INCLUDEssNoVersion].

Important

[!INCLUDEssNoteDepFutureAvoid] Use ALTER LOGIN instead.

Applies to: [!INCLUDEssNoVersion] ([!INCLUDEssKatmai] through current version).

Topic link icon Transact-SQL Syntax Conventions

Syntax

  
sp_denylogin [ @loginame = ] 'login'   

Arguments

[ @loginame = ] **'**login '
Is the name of a Windows user or group. login is sysname, with no default.

Return Code Values

0 (success) or 1 (failure)

Remarks

sp_denylogin denies CONNECT SQL permission to the server-level principal mapped to the specified Windows user or Windows group. If the server principal does not exist, it will be created. The new principal will be visible in the sys.server_principals (Transact-SQL) catalog view.

sp_denylogin cannot be executed within a user-defined transaction.

Permissions

Requires membership in the sysadmin fixed server role.

Examples

The following example shows how to use sp_denylogin to prevent Windows user CORPORATE\GeorgeV from connecting to the server.

EXEC sp_denylogin 'CORPORATE\GeorgeV';  

See Also

sp_grantlogin (Transact-SQL)
Security Stored Procedures (Transact-SQL)
ALTER LOGIN (Transact-SQL)
System Stored Procedures (Transact-SQL)