Partager via


sysmail_delete_principalprofile_sp (Transact-SQL)

Supprime l'autorisation d'utilisation d'un profil de messagerie de base de données public ou privé pour un utilisateur de base de données ou un rôle de base de données.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [ @principal_id = ] principal_id
    Correspond à l'ID de l'utilisateur de base de données dans la base de données msdb pour l'association à supprimer. L'argument principal_id est de type int avec NULL comme valeur par défaut. Pour convertir un profil public en profil privé, fournissez l'identificateur principal 0 ou le nom principal 'public'. principal_id ou principal_name doit être spécifié.

  • [ @principal_name = ] 'principal_name'
    Correspond au nom de l'utilisateur de base de données dans la base de données msdb pour l'association à supprimer. L'argument principal_name est de type sysname avec NULL comme valeur par défaut. Pour convertir un profil public en profil privé, fournissez l'identificateur principal 0 ou le nom principal 'public'. principal_id ou principal_name doit être spécifié.

  • [ @profile_id = ] profile_id
    Identificateur du profil pour l'association à supprimer. L'argument profile_id est de type int, avec NULL comme valeur par défaut. profile_id ou profile_name doit être spécifié.

  • [ @profile_name = ] 'profile_name'
    Nom du profil pour l'association à supprimer. L'argument profile_name est de type sysname, avec NULL comme valeur par défaut. profile_id ou profile_name doit être spécifié.

Valeurs du code de retour

0 (succès) ou 1 (échec)

Notes

Pour convertir un profil public en profil privé, spécifiez 'public' pour le nom principal ou 0 pour l'identificateur principal.

Soyez prudent lorsque vous supprimez des autorisations pour le profil privé par défaut d'un utilisateur ou pour le profil public par défaut. Si aucun profil n'est disponible, sp_send_dbmail nécessite le nom d'un profil comme argument. C'est pourquoi, la suppression d'un profil peut entraîner l'échec de l'appel de la procédure sp_send_dbmail. Pour plus d'informations, consultez sp_send_dbmail (Transact-SQL).

La procédure stockée sysmail_delete_principalprofile_sp se trouve dans la base de données msdb et est détenue par le schéma dbo. Cette procédure doit être exécutée avec un nom en trois parties si la base de données active n'est pas msdb.

Autorisations

Les autorisations d'exécution pour cette procédure reviennent par défaut aux membres du rôle de serveur fixe sysadmin.

Exemple

L'exemple suivant illustre la suppression de l'association entre le profil AdventureWorks Administrator et le nom d'accès ApplicationUser dans la base de données msdb.

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