sysmail_help_configure_sp (Transact-SQL)

适用范围:SQL Server

显示数据库邮件的配置设置。

Transact-SQL 语法约定

语法

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

参数

[ @parameter_name = ] 'parameter_name'

要检索的配置设置名称。 指定后,@parameter_value OUTPUT 参数中返回配置设置的值。 如果未指定@parameter_name,此存储过程将返回一个结果集,其中包含实例中的所有数据库邮件配置设置。

返回代码值

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

结果集

如果未 指定@parameter_namesysmail_help_configure_sp 则返回具有以下列的结果集。

列名称 数据类型 描述
paramname nvarchar(256) 配置参数的名称。
paramvalue nvarchar(256) 配置参数的值。
description nvarchar(256) 配置参数的说明。

注解

存储过程sysmail_help_configure_sp列出了实例的当前数据库邮件配置设置。

指定@parameter_name但未为@parameter_value提供任何输出参数时,此存储过程不会生成任何输出。

存储过程 sysmail_help_configure_sp 位于 msdb 数据库中,由 dbo 架构拥有。 如果当前数据库不是 msdb,则必须使用三部分名称调用该过程。

权限

可以授予 EXECUTE 此过程的权限,但在 SQL Server 升级期间可能会重写这些权限。

示例

以下示例显示列出 SQL Server 实例的数据库邮件配置设置。

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