sysmail_help_profileaccount_sp (Transact-SQL)

發行項
06/18/2013

列出與一個或多個 Database Mail 設定檔相關聯的帳戶。

語法

sysmail_help_profileaccount_sp
   {   [ @profile_id = ] profile_id 
      | [ @profile_name = ] 'profile_name' }
   [ , {   [ @account_id = ] account_id
         | [ @account_name = ] 'account_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 其中之一。
[ @account_id = ] account_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	設定檔的設定檔識別碼。
profile_name	sysname	設定檔的名稱。
account_id	int	帳戶的帳戶識別碼。
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. 依設定檔識別碼列出特定設定檔的帳戶

下列範例會顯示如何指定設定檔的設定檔識別碼來列出 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