• 项目

sysmail_delete_principalprofile_sp (Transact-SQL)

删除数据库用户或角色使用公共或专用数据库邮件配置文件的权限。

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

语法

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 数据库中的配置文件 AdventureWorks2008R2 Administrator 和登录名 ApplicationUser 之间的关联。

EXECUTE msdb.dbo.sysmail_delete_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks2008R2 Administrator' ;