sysmail_delete_principalprofile_sp (Transact-SQL)
適用於:SQL Server
拿掉資料庫使用者或角色使用公用或私人 Database Mail 設定檔的許可權。
語法
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
,則必須使用三部分名稱執行程式。
權限
您可以授與此 EXECUTE
程序的許可權,但這些許可權可能會在 SQL Server 升級期間覆寫。
範例
下列範例示範刪除配置檔AdventureWorks Administrator
與資料庫中登入ApplicationUser
msdb
之間的關聯。
EXEC msdb.dbo.sysmail_delete_principalprofile_sp
@principal_name = 'ApplicationUser',
@profile_name = 'AdventureWorks Administrator';