sysmail_delete_profile_sp (Transact-SQL)

發行項
12/15/2008

更新： 2006 年 12 月 12 日

刪除 Database Mail 所用的郵件設定檔。

語法

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，狀態為未傳送或正在重試的任何電子郵件訊息會更新為**「失敗」**。

如果 force_delete 等於 0，而有任何電子郵件訊息的狀態為**「未傳送」或「正在重試」**，將會引發錯誤，或如果沒有相關聯的訊息，會刪除設定檔。

傳回碼值

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;

請參閱

變更歷程記錄

版本	歷程記錄
2006 年 12 月 12 日	新增內容：將新參數 @force_delete 加入＜語法＞、＜引數＞和＜範例＞章節。

共用方式為

sysmail_delete_profile_sp (Transact-SQL)

語法

引數

傳回碼值

結果集

備註

權限

範例

請參閱

參考

其他資源

說明及資訊

變更歷程記錄

其他資源