sysmail_delete_account_sp (Transact-SQL)

Deletes a Database Mail SMTP account. You can also use the Database Mail Configuration Wizard to delete an account.

Topic link icon Transact-SQL Syntax Conventions

Syntax

sysmail_delete_account_sp { [ @account_id = ] account_id | [ @account_name = ] 'account_name' } 

Arguments

  • [ @account_id = ] account_id
    The ID number of the account to delete. account_id is int, with no default. Either account_id or account_name must be specified.

  • [ @account_name = ] 'account_name'
    The name of the account to delete. account_name is sysname, with no default. Either account_id or account_name must be specified.

Return Code Values

0 (success) or 1 (failure)

Result Sets

None

Remarks

This procedure deletes the account specified, regardless of whether the account is in use by a profile. A profile that contains no accounts cannot successfully send e-mail.

The stored procedure sysmail_delete_account_sp is in the msdb database and is owned by the dbo schema. The procedure must be executed with a three-part name if the current database is not msdb.

Permissions

Execute permissions for this procedure default to members of the sysadmin fixed server role.

Examples

The following example shows deleting the Database Mail account named AdventureWorks Administrator.

EXECUTE msdb.dbo.sysmail_delete_account_sp
    @account_name = 'AdventureWorks Administrator' ;

See Also

Reference

sysmail_add_account_sp (Transact-SQL)

sysmail_delete_profile_sp (Transact-SQL)

sysmail_delete_profileaccount_sp (Transact-SQL)

sysmail_help_account_sp (Transact-SQL)

sysmail_help_profile_sp (Transact-SQL)

sysmail_help_profileaccount_sp (Transact-SQL)

sysmail_update_profileaccount_sp (Transact-SQL)

Concepts

Database Mail

Create a Database Mail Account

Database Mail Configuration Objects