sysmail_delete_profile_sp (Transact-SQL)

Статья
12/15/2008

Изменения: 12 декабря 2006 г.

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

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

Синтаксис

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

Аргументы

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

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

[ @force_delete= ] force_delete
Аргумент force_delete имеет тип bit. По умолчанию равен 1. Если аргумент force_delete равен 1, то любые электронные сообщения с состоянием «unsent» или «retrying» будут обновлены до состояния failed.

Если аргумент force_delete равен 0 и любые сообщения имеют состояние unsent или retrying, то возникнет ошибка, а если отсутствуют связанные сообщения, то профиль будет удален.

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

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

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

Нет

Замечания

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

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

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

Разрешения

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

Примеры

В следующем примере удаляется профиль с именем AdventureWorks Administrator. Если существуют неотправленные сообщения, связанные с этим профилем, то возникнет ошибка и профиль не будет удален.

EXECUTE msdb.dbo.sysmail_delete_profile_sp
    @profile_name = N'AdventureWorks Administrator' 
    ,@force_delete = 0;

См. также

Журнал изменений

Версия	Журнал
12 декабря 2006 г.	Новое содержимое. В разделы «Синтаксис», «Аргументы» и «Примеры» добавлен новый параметр @force_delete.

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