Partilhar via


sysmail_delete_profile_sp (Transact-SQL)

Aplica-se a: SQL Server

Exclui um perfil de correio usado por Database Mail.

Convenções de sintaxe de Transact-SQL

Sintaxe

sysmail_delete_profile_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }
[ ; ]

Argumentos

@profile_id [ = ] profile_id

A ID do perfil a ser excluído. @profile_id é int, com um padrão de NULL. Deve ser especificado @profile_id ou @profile_name .

@profile_name [ = ] 'profile_name'

O nome do perfil a ser excluído. @profile_name é sysname, com um padrão de NULL. Deve ser especificado @profile_id ou @profile_name .

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Comentários

A exclusão de um perfil não exclui as contas usadas pelo perfil.

Este procedimento armazenado exclui o perfil mesmo que os usuários tenham acesso a ele. Tenha cuidado ao remover o perfil privado padrão de um usuário ou o perfil público padrão do msdb banco de dados. Quando nenhum perfil padrão está disponível, sp_send_dbmail requer o nome de um perfil como argumento. Portanto, a remoção de um perfil padrão pode fazer com que as sp_send_dbmail chamadas falhem. Para obter mais informações, consulte sp_send_dbmail (Transact-SQL).

O procedimento sysmail_delete_profile_sp armazenado está no msdb banco de dados e pertence ao esquema dbo . O procedimento deve ser executado com um nome de três partes se o banco de dados atual não msdbfor .

Permissões

Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Exemplos

O exemplo a seguir mostra a exclusão do perfil chamado AdventureWorks Administrator.

EXEC msdb.dbo.sysmail_delete_profile_sp
    @profile_name = 'AdventureWorks Administrator';