sysmail_delete_profile_sp (Transact-SQL)

Удаляет почтовый профиль, используемый компонентом Database Mail.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

sysmail_delete_profile_sp  { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }

Аргументы

  • [ @profile_id = ] profile_id
    Идентификатор профиля, который необходимо удалить. Аргумент profile_id имеет тип int и значение по умолчанию NULL. Необходимо указать аргумент profile_id или profile_name.

  • [ @profile_name = ] 'profile_name'
    Имя профиля, который необходимо удалить. Аргумент profile_name имеет тип sysname и значение по умолчанию NULL. Необходимо указать аргумент profile_id или profile_name.

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

0 (успешное завершение) или 1 (неуспешное завершение)

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

Нет

Замечания

Удаление профиля не приведет к удалению всех учетных записей, используемых данным профилем.

Эта хранимая процедура удаляет профиль в независимости от того, имеют ли пользователи к нему доступ. Будьте осторожны, удаляя частный профиль по умолчанию для пользователя или открытый профиль для базы данных msdb. Когда недоступен профиль по умолчанию, хранимая процедура sp_send_dbmail требует имя профиля в качестве аргумента. Таким образом, удаление профиля по умолчанию может повлечь неудачный вызов процедуры sp_send_dbmail. Дополнительные сведения см. в разделе Хранимая процедура sp_send_dbmail (Transact-SQL).

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

Разрешения

Разрешения на выполнение этой процедуры по умолчанию предоставляются членам предопределенной роли сервера sysadmin.

Примеры

В следующем примере удаляется профиль с именем AdventureWorks2008R2 Administrator.

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