Compartilhar via

  • Artigo

sysmail_delete_principalprofile_sp (Transact-SQL)

Remove a permissão de um usuário do banco de dados ou função para usar um perfil público ou privado do Database Mail.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sysmail_delete_principalprofile_sp  { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ,
    { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }

Argumentos

  • [ @principal_id = ] principal_id
    É o ID do usuário do banco de dados ou da função no banco de dados msdb da associação a ser excluída. principal_id é int, com um padrão NULL. Para fazer com que um perfil público se torne um perfil privado, forneça o ID principal 0 ou o nome principal 'público'. É necessário especificar a principal_id ou o principal_name.

  • [ @principal_name = ] 'principal_name'
    É o nome do usuário do banco de dados ou da função no banco de dados msdb da associação a ser excluída. principal_name é sysname, com um padrão NULL. Para fazer com que um perfil público se torne um perfil privado, forneça o ID principal 0 ou o nome principal 'público'. É necessário especificar a principal_id ou o principal_name.

  • [ @profile_id = ] profile_id
    É o ID do perfil da associação a ser excluída. profile_id é int, com um padrão NULL. É necessário especificar a profile_id ou o profile_name.

  • [ @profile_name = ] 'profile_name'
    É o nome do perfil da associação a ser excluída. profile_name é sysname, com um padrão NULL. É necessário especificar a profile_id ou o profile_name.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

Para fazer com que um perfil público se torne um perfil privado, forneça 'público' para o nome principal ou 0 para o ID principal .

Tenha cuidado ao remover permissões do perfil privado padrão para um usuário ou do perfil público padrão. Quando nenhum perfil padrão estiver disponível, sp_send_dbmail requer o nome de um perfil como um argumento. Portanto, remover um perfil padrão pode fazer com que as chamadas a sp_send_dbmail falhem. Para obter mais informações, consulte sp_send_dbmail (Transact-SQL).

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

Permissões

As permissões de execução deste procedimento usam como padrão membros da função de servidor fixa sysadmin.

Exemplos

O exemplo a seguir mostra a exclusão da associação entre o perfil AdventureWorks2008R2 Administrator e o logon ApplicationUser no banco de dados msdb.

EXECUTE msdb.dbo.sysmail_delete_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks2008R2 Administrator' ;