sysmail_delete_principalprofile_sp (Transact-SQL)
删除数据库用户或角色使用公共或专用数据库邮件配置文件的权限。
适用范围：SQL Server（SQL Server 2008 到当前版本）。 |
.gif "主题链接图标")
语法
sysmail_delete_principalprofile_sp { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ,
{ [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }
参数
[ @principal_id = ] principal_id
要删除的关联的 msdb 数据库中数据库用户或角色的 ID。 principal_id 的数据类型为 int，默认值为 NULL。 若要将公共配置文件转为专用配置文件，请提供主体数据库 ID 0 或主体数据库名称 'public'。 必须指定 principal_id 或 principal_name。[ @principal_name = ] 'principal_name'
要删除的关联的 msdb 数据库中数据库用户或角色的名称。 principal_name 的数据类型为 sysname，默认值为 NULL。 若要将公共配置文件转为专用配置文件，请提供主体数据库 ID 0 或主体数据库名称 'public'。 必须指定 principal_id 或 principal_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（失败）
注释
若要使公共配置文件成为专用配置文件，请提供主体数据库名称 'public' 或主体数据库 ID 0。
删除用户的默认专用配置文件的权限或默认公共配置文件的权限时，请谨慎操作。 如果没有可用的默认配置文件，则 sp_send_dbmail 需要使用配置文件的名称作为参数。 因此，删除默认配置文件可能会导致调用 sp_send_dbmail 失败。 有关详细信息，请参阅 sp_send_dbmail (Transact-SQL)。
存储过程 sysmail_delete_principalprofile_sp 在 msdb 数据库中，由 dbo 架构所有。 如果当前数据库不是 msdb，则该过程必须使用由三部分组成的名称执行。
权限
默认情况下，sysadmin 固定服务器角色的成员具有执行此过程的权限。
示例
以下示例显示如何删除 msdb 数据库中的配置文件 AdventureWorks Administrator 和登录名 ApplicationUser 之间的关联。
EXECUTE msdb.dbo.sysmail_delete_principalprofile_sp
@principal_name = 'ApplicationUser',
@profile_name = 'AdventureWorks Administrator' ;