sysmail_delete_profileaccount_sp (Transact-SQL)

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

适用范围:SQL Server(SQL Server 2008 到当前版本)。

主题链接图标 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,则必须使用由三部分构成的名称来执行该过程。

权限

默认情况下,sysadmin 固定服务器角色的成员拥有执行此过程的权限。

示例

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

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

请参阅

参考

数据库邮件存储过程 (Transact-SQL)

概念

数据库邮件

创建数据库邮件帐户

数据库邮件配置对象