sysmail_delete_profileaccount_sp (Transact-SQL)
从数据库邮件配置文件中删除帐户。
适用范围:SQL Server(SQL Server 2008 到当前版本)。 |
语法
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,则必须使用由三部分构成的名称来执行该过程。
权限
默认情况下,sysadmin 固定服务器角色的成员拥有执行此过程的权限。
示例
以下示例显示了如何从配置文件 AdventureWorks Administrator 中删除帐户 Audit Account。
EXECUTE msdb.dbo.sysmail_delete_profileaccount_sp
@profile_name = 'AdventureWorks Administrator',
@account_name = 'Audit Account' ;