sysmail_delete_profile_sp (Transact-SQL)
Löscht ein von Datenbank-E-Mail verwendetes E-Mail-Profil.
Syntax
sysmail_delete_profile_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }
Argumente
[ @profile_id = ] profile_id
Die Profil-ID des Profils, das gelöscht werden soll. profile_id ist vom Datentyp int und hat den Standardwert NULL. Es muss entweder profile_id oder profile_name angegeben werden.[ @profile_name = ] 'profile_name'
Der Name des Profils, das gelöscht werden soll. profile_name ist vom Datentyp sysname und hat den Standardwert NULL. Es muss entweder profile_id oder profile_name angegeben werden.
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Resultsets
Keine
Hinweise
Durch das Löschen eines Profils werden die von diesem Profil verwendeten Konten nicht gelöscht.
Durch diese gespeicherte Prozedur wird das Profil unabhängig davon gelöscht, ob Benutzer auf das Profil zugreifen können. Es ist daher Vorsicht geboten, wenn Sie das standardmäßige private Profil für einen Benutzer oder das standardmäßige öffentliche Profil für die msdb-Datenbank entfernen. Wenn kein Standardprofil verfügbar ist, muss für sp_send_dbmail der Name eines Profils als Argument angegeben werden. Deshalb kann das Entfernen eines Standardprofils dazu führen, dass Aufrufe von sp_send_dbmail einen Fehler erzeugen. Weitere Informationen finden Sie unter sp_send_dbmail (Transact-SQL).
Die gespeicherte Prozedur sysmail_delete_profile_sp befindet sich in der msdb-Datenbank. Der Besitzer ist das dbo-Schema. Handelt es sich bei der aktuellen Datenbank nicht um msdb, muss die Prozedur mit einem dreiteiligen Namen ausgeführt werden.
Berechtigungen
Standardmäßig verfügen Mitglieder der festen Serverrolle sysadmin über Berechtigungen zum Ausführen dieser Prozedur.
Beispiele
Im folgenden Beispiel wird gezeigt, wie das Profil AdventureWorks2008R2 Administrator gelöscht wird.
EXECUTE msdb.dbo.sysmail_delete_profile_sp
@profile_name = 'AdventureWorks2008R2 Administrator' ;