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';

相關內容