• 项目

sysmail_delete_profile_sp (Transact-SQL)

删除数据库邮件使用的邮件配置文件。

主题链接图标Transact-SQL 语法约定

语法

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 (Transact-SQL)。

存储过程 sysmail_delete_profile_sp 在 msdb 数据库中，归属于 dbo 架构。如果当前数据库不是 msdb，则该过程必须使用由三部分组成的名称执行。

权限

默认情况下，sysadmin 固定服务器角色的成员有执行此过程的权限。

示例

以下示例将删除名为 AdventureWorks2008R2 Administrator 的配置文件。

EXECUTE msdb.dbo.sysmail_delete_profile_sp
    @profile_name = 'AdventureWorks2008R2 Administrator' ;