分享方式:


sysmail_delete_profileaccount_sp (Transact-SQL)

適用於:SQL Server

從 Database Mail 設定檔中移除帳戶。

Transact-SQL 語法慣例

語法

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