sysmail_help_profile_sp (Transact-SQL)
Répertorie des informations sur un ou plusieurs profils de messagerie.
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. L'argument 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. L'argument 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
Renvoie un ensemble 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.