sysmail_delete_profileaccount_sp (Transact-SQL)
適用於:SQL Server
從 Database Mail 設定檔中移除帳戶。
語法
sysmail_delete_profileaccount_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
{ [ @account_id = ] account_id | [ @account_name = ] 'account_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。
[ @account_id = ] account_id
要刪除的帳戶標識碼。 @account_id 為 int,預設值為 NULL
。 可以指定@account_id或@account_name。
[ @account_name = ] 'account_name'
要刪除的帳戶名稱。 @account_name為 sysname 預設值為 NULL
。 可以指定@account_id或@account_name。
傳回碼值
0
(成功) 或 1
(失敗)。
結果集
無。
備註
如果指定的帳戶未與指定的配置檔相關聯,則傳回錯誤。
指定帳戶但未指定任何設定檔時,此預存程式會從所有設定檔中移除指定的帳戶。 例如,如果您準備關閉現有的 SMTP 伺服器,您會從所有設定檔中移除使用該 SMTP 伺服器的帳戶,而不是從每個設定檔中移除每個帳戶。
指定設定檔但未指定任何帳戶時,此預存程式會從指定的配置檔中移除所有帳戶。 例如,如果您要變更配置檔所使用的 SMTP 伺服器,從配置檔中移除所有帳戶,然後視需要新增帳戶可能很方便。
預存程式 sysmail_delete_profileaccount_sp
位於 msdb
資料庫中,且由 dbo 架構所擁有。 如果目前的資料庫不是 msdb
,則必須使用三部分名稱執行程式。
權限
此預存程式是由 db_owner 角色所擁有。 您可以授與 EXECUTE
任何用戶的許可權,但這些許可權可能會在 SQL Server 升級期間覆寫。
範例
下列範例顯示從配置檔AdventureWorks Administrator
中移除帳戶Audit Account
。
EXEC msdb.dbo.sysmail_delete_profileaccount_sp
@profile_name = 'AdventureWorks Administrator',
@account_name = 'Audit Account';