sysmail_delete_principalprofile_sp (Transact-SQL)

Mis à jour : 12 décembre 2006

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 msdb ou un rôle de base de données public.

Conventions 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 msdb ou 0 pour le rôle public. 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 ou 'public' pour pour le rôle public. 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é.

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.

Valeurs du code de retour

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

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 et SQL Mail (Transact-SQL)

Autres ressources

Messagerie de base de données
Profils de messagerie de base de données
Sélectionner une tâche de configuration (messagerie de base de données)

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications