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';