sysmail_help_configure_sp (Transact-SQL)

適用於:SQL Server

顯示 Database Mail 的組態設定。

Transact-SQL 語法慣例

語法

sysmail_help_configure_sp [ [ @parameter_name = ] 'parameter_name' ]
[ ; ]

引數

[ @parameter_name = ] 'parameter_name'

要擷取的組態設定名稱。 指定時,組態設定的值會在 @parameter_value OUTPUT 參數中傳回。 未 指定任何@parameter_name 時,這個預存程式會傳回結果集,其中包含 實例中的所有 Database Mail 組態設定。

傳回碼值

0 (成功)或 1 (失敗)。

結果集

指定@parameter_name 時, sysmail_help_configure_sp 傳回具有下列數據行的結果集。

資料行名稱 資料類型 描述
paramname nvarchar(256) 組態參數的名稱。
paramvalue nvarchar(256) 組態參數的值。
description nvarchar(256) 組態參數的描述。

備註

預存程式 sysmail_help_configure_sp 會列出 實例目前的Database Mail組態設定。

當指定@parameter_name,但未針對@parameter_value提供任何輸出參數時,此預存程式不會產生任何輸出。

預存程式 sysmail_help_configure_sp 位於 msdb 資料庫中,且由 dbo 架構所擁有。 如果目前的資料庫不是 msdb,則必須使用三部分名稱叫用程式。

權限

此預存程式是由 db_owner 角色所擁有。 您可以授與 EXECUTE 任何用戶的許可權,但這些許可權可能會在 SQL Server 升級期間覆寫。

範例

下列範例顯示列出 SQL Server 實例的 Database Mail 組態設定。

EXEC msdb.dbo.sysmail_help_configure_sp;

範例結果集如下 (行的長度經過編輯):

paramname                       paramvalue      description
------------------------------- --------------- -----------------------------------------------------------------------------
AccountRetryAttempts            1               Number of retry attempts for a mail server
AccountRetryDelay               5000            Delay between each retry attempt to mail server
DatabaseMailExeMinimumLifeTime  600             Minimum process lifetime in seconds
DefaultAttachmentEncoding       MIME            Default attachment encoding
LoggingLevel                    2               Database Mail logging level: normal - 1, extended - 2 (default), verbose - 3
MaxFileSize                     1000000         Default maximum file size
ProhibitedExtensions            exe,dll,vbs,js  Extensions not allowed in outgoing mails