sysmail_help_principalprofile_sp (Transact-SQL)

發行項
12/15/2008

更新： 2006 年 12 月 12 日

列出 Database Mail 設定檔和 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 資料庫使用者的識別碼，或若是 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
這是要列出之關聯的設定檔識別碼。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	資料庫使用者的識別碼。
principal_name	sysname	資料庫使用者的名稱。
profile_id	int	Database Mail 設定檔的識別碼。
profile_name	sysname	Database Mail 設定檔的名稱。
is_default	bit	指出設定檔是否為使用者預設設定檔的旗標。

備註

如果在未設定任何參數的情況下叫用 sysmail_help_principalprofile_sp，傳回的結果集會列出 SQL Server 執行個體中的所有關聯。否則，結果集會包含符合提供參數之關聯的資訊。例如，提供設定檔名稱時，程序便會列出設定檔的所有關聯。

sysmail_help_principalprofile_sp 在 msdb 資料庫中，擁有者是 dbo 結構描述。如果目前的資料庫不是 msdb，就必須利用三部分名稱來執行這個程序。

權限

需要系統管理員 (sysadmin) 固定伺服器角色的成員資格。

範例

A. 列出特定關聯的資訊

下列範例會顯示 AdventureWorks Administrator 設定檔和 msdb 資料庫中的 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

B. 列出所有關聯的資訊

下列範例會顯示如何列出執行個體中之所有關聯的資訊。

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp ;

範例結果集如下 (行的長度經過重新格式化)。

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
6            terrid             3           Product Update Profile         1
5            danw               9           AdventureWorks Administrator   1

請參閱

變更歷程記錄

版本	歷程記錄
2006 年 12 月 12 日	變更的內容：指定使用者為 msdb 使用者，且該角色限為 public 角色。
2006 年 4 月 14 日	變更的內容：移除不存在的 @database_id 與 @database_name 參數。

共用方式為