sp_helpremotelogin (Transact-SQL)

适用于:SQL Server

报告在本地服务器上定义的某个或所有远程服务器的远程登录名的相关信息。

重要

在 SQL Server的未来版本中将删除此功能。 请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。 请改用链接服务器和链接服务器存储过程。

Transact-SQL 语法约定

语法

  
sp_helpremotelogin [ [ @remoteserver = ] 'remoteserver' ]   
     [ , [ @remotename = ] 'remote_name' ]  

参数

[ @remoteserver= ] 'remoteserver'
远程服务器,将返回其远程登录名信息。 remoteserversysname,默认值为 NULL。 如果未 指定 remoteserver ,则会返回有关本地服务器上定义的所有远程服务器的信息。

[ @remotename= ] remote_name
远程服务器上的特定远程登录名。 remote_name为 sysname,默认值为 NULL。 如果未 指定remote_name ,则返回有关为 远程服务器 定义的所有远程用户的信息。

返回代码值

0(成功)或 1(失败)

结果集

列名称 数据类型 描述
服务器 sysname 本地服务器上定义的远程服务器的名称。
local_user_name sysname 本地服务器上的登录名,来自服务器的远程登录名映射到该登录名。
remote_user_name sysname 在映射到local_user_name的远程服务器上登录。
选项 sysname Trusted = 从远程服务器连接到本地服务器时,远程登录名不需要提供密码。

Untrusted(或空白)= 从远程服务器连接到本地服务器时,提示远程登录名提供密码。

注解

使用sp_helpserver列出本地服务器上定义的远程服务器的名称。

权限

未检查任何权限。

示例

A. 报告关于单个服务器的帮助

以下示例显示远程服务器 Accounts 上的所有远程用户的相关信息。

EXEC sp_helpremotelogin 'Accounts';  

B. 报告关于所有远程用户的帮助

以下示例显示本地服务器已知的所有远程服务器上的所有远程用户的相关信息。

EXEC sp_helpremotelogin;  

另请参阅

sp_addremotelogin (Transact-SQL)
sp_dropremotelogin (Transact-SQL)
sp_helpserver (Transact-SQL)
sp_remoteoption (Transact-SQL)
系统存储过程 (Transact-SQL)