sysmail_delete_principalprofile_sp (Transact-SQL)
更新： 2006 年 12 月 12 日
移除 msdb 資料庫使用者或 public 角色使用公用或私人 Database Mail 設定檔的權限。
.gif "主題連結圖示")
語法
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 資料庫使用者的識別碼，或若是 public 角色，則為 0。principal_id 是 int，預設值為 NULL。若要使公用設定檔進入私人設定檔中，請提供主體識別碼 0 或主體名稱 'public'。您必須指定 principal_id 或 principal_name 其中之一。
- [ @principal_name = ] 'principal_name'
這是 msdb 資料庫使用者的名稱，或若是 public 角色，則為 'public'。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 和 SQL Mail 預存程序 (Transact-SQL)
其他資源
Database Mail
Database Mail 設定檔
選取組態工作 (Database Mail)
說明及資訊
變更歷程記錄
| 版本 | 歷程記錄 |
|---|---|
2006 年 12 月 12 日 |
|