Partilhar via


sysmail_delete_profileaccount_sp (Transact-SQL)

Aplica-se a:SQL Server

Remove uma conta de um perfil do Database Mail.

Transact-SQL convenções de sintaxe

Sintaxe

sysmail_delete_profileaccount_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
    { [ @account_id = ] account_id | [ @account_name = ] 'account_name' }
[ ; ]

Argumentos

@profile_id [ = ] profile_id

O ID do perfil a ser excluído. @profile_id é int, com um padrão de NULL. O @profile_id ou o @profile_name podem ser especificados.

@profile_name [ = ] «profile_name»

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

@account_id [ = ] account_id

O ID da conta a ser excluído. @account_id é int, com um padrão de NULL. O @account_id ou o @account_name podem ser especificados.

@account_name [ = ] «account_name»

O nome da conta a ser excluída. @account_name é sysname, com um padrão de NULL. O @account_id ou o @account_name podem ser especificados.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nenhum.

Observações

Retorna um erro se a conta especificada não estiver associada ao perfil especificado.

Quando uma conta é especificada, mas nenhum perfil é especificado, esse procedimento armazenado remove a conta especificada de todos os perfis. Por exemplo, se estiver a preparar-se para encerrar um servidor SMTP existente, remova as contas que utilizam esse servidor SMTP de todos os perfis, em vez de remover cada conta de cada perfil.

Quando um perfil é especificado, mas nenhuma conta é especificada, esse procedimento armazenado remove todas as contas do perfil especificado. Por exemplo, se você estiver alterando os servidores SMTP que um perfil usa, pode ser conveniente remover todas as contas do perfil e, em seguida, adicionar novas contas conforme necessário.

O procedimento sysmail_delete_profileaccount_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

Você pode conceder permissões de EXECUTE neste procedimento, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Exemplos

O exemplo a seguir mostra a remoção da conta Audit Account do perfil AdventureWorks Administrator.

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