Partager via


sysmail_delete_profileaccount_sp (Transact-SQL)

Supprime un compte d'un profil de messagerie de base de données.

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

Syntaxe

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

Arguments

  • [ @profile_id = ] profile_id
    Identificateur du profil à supprimer. profile_id est de type int et la valeur par défaut est NULL. L'argument profile_id ou profile_name peut être spécifié.

  • [ @profile_name = ] 'profile_name'
    Nom du profil à supprimer. profile_name est de type sysname et sa valeur par défaut est NULL. L'argument profile_id ou profile_name peut être spécifié.

  • [ @account_id = ] account_id
    ID du compte à supprimer. account_id est de type int, avec NULL comme valeur par défaut. L'argument account_id ou account_name peut être spécifié.

  • [ @account_name = ] 'account_name'
    Nom du compte à supprimer. L'argument account_name est de type sysname, avec NULL comme valeur par défaut. L'argument account_id ou account_name peut être spécifié.

Valeurs des codes renvoyés

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

Ensembles de résultats

Aucun

Notes

Renvoie une erreur si le compte spécifié n'est pas associé au profil spécifié.

Lorsqu'un compte est spécifié mais pas un profil, cette procédure stockée supprime le compte spécifié de tous les profils. Par exemple, pour fermer un serveur SMTP existant, supprimez de tous les profils les comptes qui utilisent le serveur SMTP en question au lieu de supprimer chaque compte de chaque profil.

Lorsqu'un profil est spécifié mais pas un compte, cette procédure stockée supprime tous les comptes du profil spécifié. Par exemple, pour modifier les serveurs SMTP utilisés par un profil, il peut être pratique de supprimer tous les comptes du profil et d'ajouter ensuite les nouveaux comptes.

La procédure stockée sysmail_delete_profileaccount_sp se trouve dans la base de données msdb et appartient au schéma dbo. La procédure doit être exécutée avec un nom en trois parties si la base de données actuelle n'est pas msdb.

Autorisations

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

Exemple

L'exemple suivant montre la suppression du compte Audit Account du profil AdventureWorks Administrator.

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