sysmail_delete_profileaccount_sp (Transact-SQL)

S'applique à :SQL Server

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

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Les arguments

[ @profile_id = ] profile_id

ID de profil du profil à supprimer. @profile_id est int, avec la valeur par défaut NULL. On peut préciser @profile_id ou @profile_name .

[ @profile_name = ] N’profile_name'

Nom du profil à supprimer. @profile_name est sysname, avec la valeur par défaut NULL. On peut préciser @profile_id ou @profile_name .

[ @account_id = ] account_id

ID du compte à supprimer. @account_id est int, avec la valeur par défaut NULL. Soit @account_id , soit @account_name peuvent être spécifiés.

[ @account_name = ] N’account_name'

Nom du compte à supprimer. @account_name est sysname, avec la valeur par défaut NULL. Soit @account_id , soit @account_name peuvent être spécifiés.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Jeu de résultats

Aucune.

Notes

Retourne 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, si vous préparez à arrêter un serveur SMTP existant, vous supprimez les comptes qui utilisent ce serveur SMTP de tous les profils, plutôt que 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, si vous modifiez les serveurs SMTP qu’un profil utilise, il peut être pratique de supprimer tous les comptes du profil, puis d’ajouter de nouveaux comptes si nécessaire.

La procédure sysmail_delete_profileaccount_sp stockée se trouve dans la msdb base de données 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

Vous pouvez accorder EXECUTE des autorisations sur cette procédure, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.

Exemples

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';