sysmail_delete_principalprofile_sp (Transact-SQL)
更新日期： 2006 年 12 月 12 日
删除 msdb 数据库用户或 public 角色使用公共或专用数据库邮件配置文件的权限。
.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；对于 public 角色，该参数为 0。principal_id 的数据类型为 int，默认值为 NULL。若要将公共配置文件转为专用配置文件，请提供主体数据库 ID 0 或主体数据库名称 'public'。必须指定 principal_id 或 principal_name。
- [ @principal_name = ] 'principal_name'
msdb 数据库用户的名称；对于 public 角色，该参数为 'public'。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' ;
请参阅
参考
数据库邮件和 SQL 邮件存储过程 (Transact-SQL)
其他资源
帮助和信息
更改历史记录
| 发布日期 | 历史记录 |
|---|---|
2006 年 12 月 12 日 |
|