Freigeben über


sysmail_delete_profile_sp (Transact-SQL)

Löscht ein von Datenbank-E-Mail verwendetes E-Mail-Profil.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

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. Der Standardwert ist 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. Der Standardwert ist 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 AdventureWorks Administrator gelöscht wird.

EXECUTE msdb.dbo.sysmail_delete_profile_sp
    @profile_name = 'AdventureWorks Administrator' ;

Siehe auch

Verweis

Gespeicherte Prozeduren für Datenbank-E-Mail (Transact-SQL)

Konzepte

Datenbank-E-Mail

Konfigurationsobjekte für Datenbank-E-Mail