sysmail_help_profile_sp (Transact-SQL)

Répertorie des informations sur un ou plusieurs profils de messagerie.

S'applique à : SQL Server (SQL Server 2008 via la version actuelle).

Conventions de la syntaxe Transact-SQL

Syntaxe

sysmail_help_profile_sp  [   [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' ]

Arguments

• [ @profile_id = ] profile_id
  Identificateur du profil pour lequel des informations doivent être renvoyées. profile_id est de type int, avec NULL comme valeur par défaut.

• [ @profile_name = ] 'profile_name'
  Nom du profil pour lequel des informations doivent être renvoyées. profile_name est de type sysname, avec NULL comme valeur par défaut.

Valeurs des codes de retour

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

Ensembles de résultats

Retourne un jeu de résultats comportant les colonnes suivantes.

Nom de la colonne	Type de données	Description
profile_id	int	Identificateur du profil.
name	sysname	Nom du profil.
description	nvarchar(256)	Description du profil.

Notes

Lorsqu'un nom ou un ID de profil est spécifié, sysmail_help_profile_sp renvoie les informations concernant ce profil. Dans le cas contraire, sysmail_help_profile_sp renvoie des informations sur chacun des profils de l'instance SQL Server.

La procédure stockée sysmail_help_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 active 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.

Exemples

A. Affichage de tous les profils

Cet exemple montre comment afficher tous les profils de l'instance.

EXECUTE msdb.dbo.sysmail_help_profile_sp;

Exemple d'un ensemble de résultats remis en forme au niveau de la longueur de ligne :

profile_id  name                          description
----------- ----------------------------- ------------------------------
56          AdventureWorks Administrator  Administrative mail profile.  
57          AdventureWorks Operator       Operator mail profile.        

B. Affichage d'un profil spécifique

Cet exemple montre comment afficher des informations pour le profil AdventureWorks Administrator.

EXECUTE msdb.dbo.sysmail_help_profile_sp
    @profile_name = 'AdventureWorks Administrator' ;

Exemple d'un ensemble de résultats remis en forme au niveau de la longueur de ligne :

profile_id  name                          description
----------- ----------------------------- ------------------------------
56          AdventureWorks Administrator  Administrative mail profile.  

Voir aussi

Référence

Procédures stockées de messagerie de base de données (Transact-SQL)

Concepts

Messagerie de base de données