sysmail_help_profileaccount_sp (Transact-SQL)

项目
03/07/2014

列出与一个或多个数据库邮件配置文件相关联的帐户。

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

语法

sysmail_help_profileaccount_sp
   {   [ @profile_id = ] profile_id 
      | [ @profile_name = ] 'profile_name' }
   [ , {   [ @account_id = ] account_id
         | [ @account_name = ] 'account_name' } ]

参数

[ @profile_id = ] profile_id
要列出的配置文件的 ID。 profile_id 的数据类型为 int，默认值为 NULL。必须指定 profile_id 或 profile_name。
[ @profile_name = ] 'profile_name'
要列出的配置文件的名称。 profile_name 的数据类型为 sysname，默认值为 NULL。必须指定 profile_id 或 profile_name。
[ @account_id = ] account_id
要列出的帐户 ID。 account_id 的数据类型为 int，默认值为 NULL。当 account_id 和 account_name 同时为 NULL 时，则列出配置文件中的所有帐户。
[ @account_name = ] 'account_name'
要列出的帐户的名称。 account_name 的数据类型为 sysname，默认值为 NULL。当 account_id 和 account_name 同时为 NULL 时，则列出配置文件中的所有帐户。

返回代码值

0（成功）或 1（失败）

结果集

返回包含以下列的结果集。

列名	数据类型	说明
profile_id	int	配置文件的配置文件 ID。
profile_name	sysname	配置文件的名称。
account_id	int	帐户的帐户 ID。
account_name	sysname	帐户的名称。
sequence_number	int	配置文件中的帐户的序号。

注释

如果未指定 profile_id 或 profile_name，则此存储过程将返回实例中的每个配置文件的信息。

存储过程 sysmail_help_profileaccount_sp 在 msdb 数据库中，并且由 dbo 架构拥有。如果当前数据库不是 msdb，则必须使用由三部分构成的名称来执行该过程。

权限

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

示例

A. 按名称列出特定配置文件的帐户

以下示例通过指定配置文件名称以列出 AdventureWorks Administrator 配置文件的信息。

EXECUTE msdb.dbo.sysmail_help_profileaccount_sp
   @profile_name = 'AdventureWorks Administrator';

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

profile_id  profile_name                 account_id  account_name         sequence_number
----------- ---------------------------- ----------- -------------------- ---------------
131         AdventureWorks Administrator 197         Admin-MainServer     1
131         AdventureWorks Administrator 198         Admin-BackupServer   2

B. 按配置文件 ID 列出特定配置文件的帐户

以下示例通过指定配置文件的配置文件 ID 以列出 AdventureWorks Administrator 配置文件的信息。

EXECUTE msdb.dbo.sysmail_help_profileaccount_sp
    @profile_id = 131 ;

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

profile_id  profile_name                 account_id  account_name         sequence_number
----------- ---------------------------- ----------- -------------------- ---------------
131         AdventureWorks Administrator 197         Admin-MainServer     1
131         AdventureWorks Administrator 198         Admin-BackupServer   2

C. 列出所有配置文件的帐户

以下示例列出实例中的所有配置文件的帐户。

EXECUTE msdb.dbo.sysmail_help_profileaccount_sp;

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

profile_id  profile_name                 account_id  account_name         sequence_number
----------- ---------------------------- ----------- -------------------- ---------------
131         AdventureWorks Administrator 197         Admin-MainServer     1
131         AdventureWorks Administrator 198         Admin-BackupServer   2
106         AdventureWorks Operator      210         Operator-MainServer  1