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.
.gif "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)
Other Resources
Database Mail
Database Mail Accounts
Database Mail Profiles
Select Configuration Task (Database Mail)