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.

S'applique à : SQL Server (SQL Server 2008 via la version actuelle).

Conventions de la syntaxe 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 ou du rôle de base de données dans la base de données msdb pour l'association à supprimer. 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 ou du rôle de base de données dans la base de données msdb pour l'association à supprimer. 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. 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. 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' ;

Voir aussi

Référence

Procédures stockées de messagerie de base de données (Transact-SQL)

Concepts

Messagerie de base de données

Objets de configuration de la messagerie de base de données