sysmail_help_profile_sp (Transact-SQL)

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

Icône Lien de rubriqueConventions de la syntaxe de 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. 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          AdventureWorks2008R2 Administrator  Administrative mail profile.  
57          AdventureWorks2008R2 Operator       Operator mail profile.        

B. Affichage d'un profil spécifique

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

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

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

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