Partage via


sysmail_help_profile_sp (Transact-SQL)

S'applique à : SQL Server

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

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @profile_id = ] profile_id

ID de profil pour lequel retourner des informations. @profile_id est int, avec la valeur par défaut NULL.

[ @profile_name = ] 'profile_name'

Nom du profil pour lequel des informations doivent être renvoyées. @profile_name est sysname, avec la valeur par défaut NULL.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu 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 ID de profil du profil.
name sysname Nom du profil pour le profil.
description nvarchar (256) Description du profil.

Notes

Lorsqu’un nom de profil ou un ID de profil est spécifié, sysmail_help_profile_sp retourne des informations sur ce profil. Sinon, sysmail_help_profile_sp retourne des informations sur chaque profil dans l’instance SQL Server.

La procédure sysmail_help_profile_sp stockée se trouve dans la msdb base de données et appartient au schéma dbo . La procédure doit être exécutée avec un nom en trois parties si la base de données actuelle n’est pas msdb.

autorisations

Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE des autorisations pour n’importe quel utilisateur, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.

Exemples

R. Répertorier tous les profils

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

EXEC 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. Répertorier un profil spécifique

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

EXEC 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.