sysmail_delete_profile_sp (Transact-SQL)
適用於:SQL Server
刪除 Database Mail 所使用的郵件設定檔。
語法
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。
預存程式 sysmail_delete_profile_sp
位於 msdb
資料庫中,且由 dbo 架構所擁有。 如果目前的資料庫不是 msdb
,則必須使用三部分名稱執行程式。
權限
您可以授與此 EXECUTE
程序的許可權,但這些許可權可能會在 SQL Server 升級期間覆寫。
範例
下列範例示範刪除名為 AdventureWorks Administrator
的配置檔。
EXEC msdb.dbo.sysmail_delete_profile_sp
@profile_name = 'AdventureWorks Administrator';