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


sysmail_delete_profile_sp (Transact-SQL)

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

Удаляет профиль электронной почты, используемый компонентом 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является.

Разрешения

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

Примеры

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

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