xp_grantlogin (Transact-SQL)

授予 Windows 组或用户对 SQL Server 的访问权限。

重要说明重要提示

后续版本的 Microsoft SQL Server 将删除该功能。请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。请改用 CREATE LOGIN

主题链接图标Transact-SQL 语法约定

语法

xp_grantlogin {[@loginame = ] 'login'} [,[@logintype = ] 'logintype']

参数

  • [ @loginame = ] 'login'
    要添加的 Windows 用户或用户组的名称。必须使用以下形式通过 Windows 域名限定 Windows 用户或用户组:Domain\User;login 的数据类型为 sysname,没有默认值。

  • [ @logintype = ] 'logintype'
    将授予其访问权限的登录名的安全级别。logintype 的数据类型为 varchar(5),默认值为 NULL。只能指定 admin。如果指定 admin,则 login 将被授予访问 SQL Server 的权限,并被添加为 sysadmin 固定服务器角色的成员。

返回代码值

0(成功)或 1(失败)

注释

现在,xp_grantlogin 是一个系统存储过程而非扩展存储过程。xp_grantlogin 将调用 sp_grantloginsp_addsrvrolemember

权限

要求具有 securityadmin 固定服务器角色的成员身份。更改 logintype 时,要求具有 sysadmin 固定服务器角色的成员身份。