Поделиться через


sysmail_help_profile_sp (Transact-SQL)

Область применения: SQL Server

Отображает сведения об одном или нескольких профилях электронной почты.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @profile_id = ] profile_id

Идентификатор профиля для возврата сведений. @profile_id имеет значение int с значением по умолчаниюNULL.

[ @profile_name = ] 'profile_name'

Имя профиля, для которого возвращаются сведения. @profile_name имеет имя sysname с значением по умолчаниюNULL.

Значения кода возврата

0 (успешно) или 1 (сбой).

Результирующий набор

Возвращает результирующий набор со следующими столбцами.

Имя столбца Тип данных Description
profile_id int Идентификатор профиля для профиля.
name sysname Имя профиля.
description nvarchar(256) Описание профиля.

Замечания

При указании sysmail_help_profile_sp имени профиля или идентификатора профиля возвращает сведения об этом профиле. sysmail_help_profile_sp В противном случае возвращает сведения о каждом профиле в экземпляре SQL Server.

Хранимая процедура sysmail_help_profile_sp находится в msdb базе данных и принадлежит схеме dbo . Процедура должна выполняться с трехкомпонентным именем, если текущая база данных не msdbявляется.

Разрешения

Эта хранимая процедура принадлежит роли db_owner . Вы можете предоставить EXECUTE разрешения для любого пользователя, но эти разрешения могут быть переопределены во время обновления SQL Server.

Примеры

А. Вывод списка всех профилей

Этот пример отображает список всех профилей экземпляра.

EXEC msdb.dbo.sysmail_help_profile_sp;

Далее приведен образец результирующего набора, повторно форматированный под длину строки:

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

B. Перечисление определенного профиля

Этот пример отображает сведения для профиля AdventureWorks Administrator.

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

Далее приведен образец результирующего набора, повторно форматированный под длину строки:

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