sysmail_help_account_sp (Transact-SQL)

列出有关数据库邮件帐户的信息（密码除外）。

适用范围：SQL Server（SQL Server 2008 到当前版本）。

Transact-SQL 语法约定

语法

sysmail_help_account_sp [ [ @account_id = ] account_id | [ @account_name = ] 'account_name' ]

参数

• [ @account_id = ] account_id
  列出其帐户信息的帐户的 ID。 account_id 的数据类型为 int，默认值为 NULL。

• [ @account_name = ] 'account_name'
  列出其帐户信息的帐户的名称。 account_name 的数据类型为 sysname，默认值为 NULL。

返回代码值

0（成功）或 1（失败）

结果集

返回包含下面列出的列的结果集。

列名	数据类型	说明
account_id	int	帐户 ID。
name	sysname	帐户名称。
description	nvarchar(256)	对帐户的说明。
email_address	nvarchar(128)	发送消息的电子邮件地址。
display_name	nvarchar(128)	帐户的显示名称。
replyto_address	nvarchar(128)	对于来自此帐户的消息发送答复的地址。
servertype	sysname	用于此帐户的电子邮件服务器的类型。
servername	sysname	用于此帐户的电子邮件服务器的名称。
port	int	电子邮件服务器使用的端口号。
username	nvarchar(128)	登录电子邮件服务器所用的用户名（如果电子邮件服务器使用身份验证）。 当 username 为 NULL 时，数据库邮件不对此帐户使用身份验证。
use_default_credentials	bit	指定是否使用 SQL Server 数据库引擎的凭据将邮件发送到 SMTP 服务器。 use_default_credentials 的数据类型为 bit，无默认值。 当此参数为 1 时，数据库邮件使用 SQL Server 数据库引擎服务的凭据。 当此参数为 0 时，数据库邮件使用 @username 和 @password 在 SMTP 服务器上进行身份验证。 如果 @username 和 @password 为 NULL，则数据库邮件使用匿名身份验证。 在指定此参数之前，请咨询您的 SMTP 管理员。
enable_ssl	bit	指定数据库邮件是否使用安全套接字层 (SSL) 对通信进行加密。 如果 SMTP 服务器需要 SSL，则使用该选项。 enable_ssl 的数据类型为 bit，无默认值。 1 指示数据库邮件使用 SSL 对通信进行加密。 0 指示数据库邮件发送未使用 SSL 进行加密的邮件。

注释

如果未提供 account_id 或 account_name，则 sysmail_help_account 将列出有关 Microsoft SQL Server 实例中所有数据库邮件帐户的信息。

存储过程 sysmail_help_account_sp 位于 msdb 数据库，属于 dbo 架构。 如果当前数据库不是 msdb，则必须使用由三部分构成的名称来执行该过程。

权限

此过程的执行权限默认授予 sysadmin 固定服务器角色的成员。

示例

A. 列出所有帐户的信息

以下示例列出该实例所有帐户的帐户信息。

EXECUTE msdb.dbo.sysmail_help_account_sp ;

下面是示例结果集，由于行的长度原因而进行了编辑：

account_id  name                         description                             email_address             display_name                     replyto_address servertype servername                port        username use_default_credentials enable_ssl
----------- ---------------------------- --------------------------------------- ------------------------- -------------------------------- --------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148         AdventureWorks Administrator Mail account for administrative e-mail. dba@Adventure-Works.com   AdventureWorks Automated Mailer  NULL            SMTP       smtp.Adventure-Works.com  25          NULL 0                          0      
149         Audit Account                Account for audit e-mail.               audit@Adventure-Works.com Automated Mailer (Audit)         NULL            SMTP       smtp.Adventure-Works.com  25          NULL 0                          0      

B. 列出特定帐户的信息

以下示例列出名为 AdventureWorks Administrator 的帐户信息。

EXECUTE msdb.dbo.sysmail_help_account_sp
    @account_name = 'AdventureWorks Administrator' ;

下面是示例结果集，由于行的长度原因而进行了编辑：

account_id  name                         description                             email_address             display_name                     replyto_address servertype servername                port        username use_default_credentials enable_ssl
----------- ---------------------------- ------------------------------------------------------ ------------------------- ---------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148         AdventureWorks Administrator Mail account for administrative e-mail. dba@Adventure-Works.com   AdventureWorks Automated Mailer  NULL            SMTP       smtp.Adventure-Works.com  25          NULL     0                       0     

请参阅

参考

数据库邮件存储过程 (Transact-SQL)

概念

数据库邮件

创建数据库邮件帐户