sysmail_delete_profile_sp (Transact-SQL)
适用范围:SQL Server
删除数据库邮件使用的邮件配置文件。
语法
sysmail_delete_profile_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }
[ ; ]
参数
[ @profile_id = ] profile_id
要删除的配置文件的配置文件 ID。 @profile_id为 int,默认值为 NULL
. 必须指定@profile_id或@profile_name。
[ @profile_name = ] 'profile_name'
要删除的配置文件的名称。 @profile_name为 sysname,默认值为 NULL
. 必须指定@profile_id或@profile_name。
返回代码值
0
(成功)或 1
(失败)。
结果集
无。
注解
删除配置文件不会删除配置文件使用的帐户。
此存储过程删除配置文件时,不考虑用户是否有权访问该配置文件。 删除用户的默认专用配置文件或数据库的默认公共配置文件 msdb
时,请谨慎使用。 如果没有可用的默认配置文件, sp_send_dbmail
则需要将配置文件的名称作为参数。 因此,删除默认配置文件可能会导致调用 sp_send_dbmail
失败。 有关详细信息,请参阅 sp_send_dbmail。
存储过程 sysmail_delete_profile_sp
位于 msdb
数据库中,由 dbo 架构拥有。 如果当前数据库不是 msdb
,则必须使用三部分名称执行该过程。
权限
可以授予 EXECUTE
此过程的权限,但在 SQL Server 升级期间可能会重写这些权限。
示例
以下示例将删除名为 AdventureWorks Administrator
的配置文件。
EXEC msdb.dbo.sysmail_delete_profile_sp
@profile_name = 'AdventureWorks Administrator';