sysmail_delete_principalprofile_sp (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 dans la base de données msdb pour l'association à supprimer. 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 pour l'association à supprimer. 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é.

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

Concepts