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 （Transact-SQL） 。

預存程式 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';

相關內容