分享方式:


sysmail_delete_principalprofile_sp (Transact-SQL)

適用於:SQL Server

拿掉資料庫使用者或角色使用公用或私人 Database Mail 設定檔的許可權。

Transact-SQL 語法慣例

語法

sysmail_delete_principalprofile_sp { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ,
    { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }
[ ; ]

引數

[ @principal_id = ] principal_id

資料庫中要刪除之關聯之資料庫使用者或角色 msdb 的標識碼。 @principal_id為 int,預設值為 NULL。 若要將公用設定檔設為私人設定檔,請提供主體識別碼 0 或主體名稱 public必須指定@principal_id@principal_name

[ @principal_name = ] 'principal_name'

資料庫中要刪除之關聯的資料庫使用者或角色 msdb 名稱。 @principal_name為 sysname 預設值為 NULL。 若要將公用設定檔設為私人設定檔,請提供主體識別碼 0 或主體名稱 public必須指定@principal_id@principal_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 (失敗)。

備註

若要將公用配置檔設為私人配置檔,請提供主體名稱或0主體標識碼的「公用」

拿掉使用者或預設公用設定檔的預設私人設定檔許可權時,請小心。 當沒有可用的預設配置檔時, sp_send_dbmail 需要配置檔的名稱做為自變數。 因此,移除預設配置檔會導致呼叫 sp_send_dbmail 失敗。 如需詳細資訊,請參閱 sp_send_dbmail

預存程式 sysmail_delete_principalprofile_sp 位於 msdb 資料庫中,且由 dbo 架構所擁有。 如果目前的資料庫不是 msdb,則必須使用三部分名稱執行程式。

權限

此預存程式是由 db_owner 角色所擁有。 您可以授與 EXECUTE 任何用戶的許可權,但這些許可權可能會在 SQL Server 升級期間覆寫。

範例

下列範例示範刪除配置檔AdventureWorks Administrator與資料庫中登入ApplicationUsermsdb之間的關聯。

EXEC msdb.dbo.sysmail_delete_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks Administrator';