sysmail_delete_profile_sp (Transact-SQL)

Article
12/15/2008

Mis à jour : 12 décembre 2006

Supprime un profil de messagerie utilisé par la messagerie de base de données.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

sysmail_delete_profile_sp  { [ @profile_id = ] profile_id | [    
        @profile_name = ] 'profile_name' } 
    [, [ @force_delete = ] force_delete ]

Arguments

[ @profile_id= ] profile_id
Id du profil à supprimer. profile_id est de type int et prend NULL comme valeur par défaut. profile_id ou profile_name doit être spécifié.

[ @profile_name= ] 'profile_name'
Nom du profil à 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é.

[ @force_delete= ] force_delete
L'argument force_delete est de type bit. Default = 1. Si force_delete est égal à 1, les messages électroniques dont l'état est unsent ou retrying seront mis à jour vers failed.

Si force_delete est égal à 0 et que les messages électroniques ont pour état unsent ou retrying, une erreur est signalée, ou, en l'absence de message associé, le profil est supprimé.

Jeux de résultats

Aucun

Notes

La suppression d'un profil ne supprime pas les comptes utilisés par ce profil.

Cette procédure stockée supprime le profil que les utilisateurs disposent d'un accès au profil ou non. Soyez attentif lors de la suppression du profil privé par défaut d'un utilisateur ou du profil public par défaut de la base de données msdb. Lorsque aucun profil par défaut n'est disponible, sp_send_dbmail nécessite le nom d'un profil sous forme d'argument. Par conséquent, la suppression d'un profil par défaut risque d'entraîner l'échec des appels vers sp_send_dbmail. Pour plus d'informations, consultez sp_send_dbmail (Transact-SQL).

La procédure stockée sysmail_delete_profile_sp se trouve dans la base de données msdb et appartient au schéma dbo. Cette procédure doit être exécutée avec un nom en trois parties si la base de données en cours 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.

Valeurs du code de retour

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

Exemples

L'exemple suivant illustre la suppression du profil nommé AdventureWorks Administrator. Si des messages non envoyés (unsent) sont associés à ce profil, une erreur est signalée et le profil est supprimé.

EXECUTE msdb.dbo.sysmail_delete_profile_sp
    @profile_name = N'AdventureWorks Administrator' 
    ,@force_delete = 0;

Voir aussi

Historique des modifications

Version	Historique
12 décembre 2006	Nouveau contenu : Ajout du nouveau paramètre @force_delete aux sections Syntaxe, Arguments, et Exemple.

Partager via