適用於：
SQL Server
列出 Database Mail 配置檔與資料庫主體之間的關聯相關信息。
語法
dbo.sysmail_help_principalprofile_sp
{ [ @principal_id = ] principal_id
| [ @principal_name = ] N'principal_name' }
[ , [ @profile_id = ] profile_id ]
[ , [ @profile_name = ] N'profile_name' ]
[ ; ]
引數
[ @principal_id = ] principal_id
資料庫中要列出關聯之資料庫使用者或角色 msdb 的標識碼。
@principal_id為 intNULL。
必須指定@principal_id或@principal_name。
[ @principal_name = ] N'principal_name
資料庫中要列出關聯之資料庫使用者或角色 msdb 的名稱。
@principal_name為 sysname 預設值為 NULL。
必須指定@principal_id或@principal_name。
[ @profile_id = ] profile_id
要列出之關聯之配置檔的標識碼。
@profile_id為 intNULL。
您可以指定@profile_id或@profile_name。
[ @profile_name = ] N'profile_name'
要列出之關聯之配置檔的名稱。
@profile_name為 sysnameNULL。
您可以指定@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，則必須使用三部分名稱執行程式。
權限
您可以授與此 EXECUTE 程序的許可權，但這些許可權可能會在 SQL Server 升級期間覆寫。
範例
A. 列出特定關聯的資訊
下列範例顯示列出配置檔與AdventureWorks Administrator資料庫中主體ApplicationLogin之間msdb所有關聯的資訊。
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