sysmail_delete_principalprofile_sp (Transact-SQL)

  • 發行項

移除資料庫使用者或使用公用或私人 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 (失敗)

備註

若要使公用設定檔進入私人設定檔中，請在主體名稱中提供 'public'，在主體識別碼中提供 0。

當移除使用者預設私人設定檔的權限，或移除預設公用設定檔的權限時，請特別小心。 當沒有可用的預設設定檔時，sp_send_dbmail 需要以設定檔的名稱為引數。 因此，移除預設設定檔可能會使 sp_send_dbmail 呼叫失敗。 如需詳細資訊，請參閱＜sp_send_dbmail (Transact-SQL)＞。

預存程序 sysmail_delete_principalprofile_sp 在 msdb 資料庫中，擁有者是 dbo 結構描述。 如果目前的資料庫不是 msdb，就必須利用三部分名稱來執行這個程序。

權限

這個程序的執行權限預設會授與系統管理員 (sysadmin) 固定伺服器角色的成員。

範例

下列範例會顯示如何刪除 AdventureWorks Administrator 設定檔和 msdb 資料庫中之 ApplicationUser 登入之間的關聯。

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

請參閱

參考

Database Mail 預存程序 (Transact-SQL)

概念

Database Mail

Database Mail 組態物件