sysmail_help_account_sp (Transact-SQL)

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

主题链接图标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_idaccount_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     

请参阅

参考

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

其他资源

数据库邮件
数据库邮件配置向导
选择配置任务(数据库邮件)
数据库邮件帐户

帮助和信息

获取 SQL Server 2005 帮助