共用方式為

  • 發行項

sysmail_help_profile_sp (Transact-SQL)

列出一或多個郵件設定檔的相關資訊。

主題連結圖示Transact-SQL 語法慣例

語法

sysmail_help_profile_sp  [   [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' ]

引數

  • [@profile_id = ] profile_id
    要傳回資訊的設定檔識別碼。profile_id 是 int，預設值是 NULL。

  • [@profile_name = ] 'profile_name'
    要傳回資訊的設定檔名稱。profile_name 是 sysname，預設值是 NULL。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

傳回含下列資料行的結果集。

資料行名稱

資料類型

描述

profile_id

int

設定檔的設定檔識別碼。

name

sysname

設定檔的設定檔名稱。

description

nvarchar(256)

設定檔的描述。

備註

當指定設定檔名稱或設定檔識別碼時，sysmail_help_profile_sp 會傳回這個設定檔的相關資訊。否則，sysmail_help_profile_sp 會傳回 SQL Server 執行個體中每個設定檔的相關資訊。

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

權限

這個程序的執行權限預設會授與系統管理員 (sysadmin) 固定伺服器角色的成員。

範例

A. 列出所有設定檔

下列範例會顯示如何列出執行個體中的所有設定檔。

EXECUTE msdb.dbo.sysmail_help_profile_sp;

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

profile_id  name                          description
----------- ----------------------------- ------------------------------
56          AdventureWorks Administrator  Administrative mail profile.  
57          AdventureWorks Operator       Operator mail profile.

B. 列出特定設定檔

下列範例會顯示如何列出 AdventureWorks Administrator 設定檔的資訊。

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

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

profile_id  name                          description
----------- ----------------------------- ------------------------------
56          AdventureWorks Administrator  Administrative mail profile.