sp_grantlogin (Transact-SQL)

THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Creates a SQL Server login.

Important

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. Use CREATE LOGIN instead.

||
|-|
|Applies to: SQL Server ( SQL Server 2008 through current version).|

Topic link icon Transact-SQL Syntax Conventions

Syntax


sp_grantlogin [@loginame=] 'login'  

Arguments

[ @loginame = ] 'login'
Is the name of a Windows user or group. The Windows user or group must be qualified with a Windows domain name in the form Domain\User; for example, London\Joeb. login is sysname, with no default.

Return Code Values

0 (success) or 1 (failure)

Remarks

sp_grantlogin calls CREATE LOGIN, which supports additional options. For information on creating SQL Server logins, see CREATE LOGIN (Transact-SQL)

sp_grantlogin cannot be executed within a user-defined transaction.

Permissions

Requires ALTER ANY LOGIN permission on the server.

Examples

The following example uses CREATE LOGIN to create a SQL Server login for the Windows user Corporate\BobJ. This is the preferred method.

CREATE LOGIN [Corporate\BobJ] FROM WINDOWS;  
GO  

See Also

Security Stored Procedures (Transact-SQL)
CREATE LOGIN (Transact-SQL)
System Stored Procedures (Transact-SQL)