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_spmsdb 資料庫中,擁有者是 dbo 結構描述。 如果目前的資料庫不是 msdb,就必須利用三部分名稱來執行這個程序。

權限

這個程序的執行權限預設會授與系統管理員 (sysadmin) 固定伺服器角色的成員。

範例

下列範例會刪除名稱為 AdventureWorks Administrator 的設定檔。

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

請參閱

參考

Database Mail 預存程序 (Transact-SQL)

概念

Database Mail

Database Mail 組態物件