sysmail_help_principalprofile_sp (Transact-SQL)

项目
12/15/2008

更新日期： 2006 年 12 月 12 日

列出有关数据库邮件配置文件和 msdb 数据库主体之间关联的信息。

语法

 sysmail_help_principalprofile_sp [ {   [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ]     [ [ , ] {   [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ]

参数

[ @principal_id= ] principal_id
msdb 数据库用户的 ID；对于 public 角色，该参数为 0。principal_id 的数据类型为 int，默认值为 NULL。可以指定 principal_id 或 principal_name。

[ @principal_name= ] 'principal_name'
msdb 数据库用户的名称；对于 public 角色，该参数为 'public'。principal_name 的数据类型为 sysname，默认值为 NULL。可以指定 principal_id 或 principal_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。

返回代码值

0（成功）或 1（失败）

结果集

返回一个结果集，其中包含下表中列出的列。

列名	数据类型	说明
principal_id	int	数据库用户的 ID。
principal_name	sysname	数据库用户的名称。
profile_id	int	数据库邮件配置文件的 ID 号。
profile_name	sysname	数据库邮件配置文件的名称。
is_default	bit	声明配置文件是否为用户的默认配置文件的标志。

备注

如果在不带参数的情况下调用 sysmail_help_principalprofile_sp，则返回的结果集将列出 SQL Server 实例中的所有关联。否则，结果集将包含与所提供参数相匹配的关联的信息。例如，提供配置文件名称时，该过程会列出配置文件的所有关联。

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

权限

要求具有 sysadmin 固定服务器角色的成员身份。

示例

列出特定关联的信息

以下示例显示如何列出 msdb 数据库中 AdventureWorks Administrator 配置文件和 ApplicationLogin 主体之间的所有关联的信息。

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp
    @principal_name = 'danw',
    @profile_name = 'AdventureWorks Administrator' ;

下面是行长度经过调整的示例结果集。

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
5            danw               9           AdventureWorks Administrator   1

列出所有关联的信息

以下示例显示如何列出该实例中所有关联的信息。

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp ;