sysmail_delete_profileaccount_sp (Transact-SQL)

  • 项目

适用于：SQL Server

从数据库邮件配置文件中删除帐户。

Transact-SQL 语法约定

语法

sysmail_delete_profileaccount_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
    { [ @account_id = ] account_id | [ @account_name = ] 'account_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。

[ @account_id = ] account_id

要删除的帐户 ID。 @account_id为 int，默认值为 NULL. 可以指定@account_id或@account_name。

[ @account_name = ] 'account_name'

要删除的帐户的名称。 @account_name为 sysname，默认值为 NULL. 可以指定@account_id或@account_name。

返回代码值

0（成功）或 1（失败）。

结果集

无。

注解

如果指定的帐户未与指定的配置文件关联，则返回错误。

如果指定了帐户但没有指定配置文件，此存储过程会从所有配置文件中删除指定的帐户。 例如，如果准备关闭现有 SMTP 服务器，请从所有配置文件中删除使用该 SMTP 服务器的帐户，而不是从每个配置文件中删除每个帐户。

如果指定了配置文件但没有指定帐户，此存储过程将从指定的配置文件中删除所有帐户。 例如，如果要更改配置文件使用的 SMTP 服务器，从配置文件中删除所有帐户，然后根据需要添加新帐户可能很方便。

存储过程 sysmail_delete_profileaccount_sp 位于 msdb 数据库中，由 dbo 架构拥有。 如果当前数据库不是 msdb，则必须使用三部分名称执行该过程。

权限

此存储过程由 db_owner 角色拥有。 你可以为任何用户授予 EXECUTE 权限，但这些权限可能会在 SQL Server 升级期间被重写。

示例

以下示例显示了如何从配置文件 Audit Account 中删除帐户 AdventureWorks Administrator。

EXEC msdb.dbo.sysmail_delete_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Audit Account';

相关内容