sysmail_delete_profile_sp (Transact-SQL)

Artikel
12/15/2008

Aktualisiert: 12. Dezember 2006

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' } 
    [, [ @force_delete = ] force_delete ]

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.

[ @force_delete= ] force_delete
force_delete ist vom Datentyp bit. Standardeinstellung = 1. Wenn force_delete gleich 1 ist, werden sämtliche E-Mail-Nachrichten mit Status unsent oder retrying auf failed aktualisiert.

Wenn force_delete gleich 0 ist und mindestens eine E-Mail-Nachricht den Status unsent oder retrying aufweist, wird ein Fehler ausgelöst, oder, wenn keine zugeordneten Nachrichten vorliegen, wird das Profil gelöscht.

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. Das Entfernen eines Standardprofils kann daher 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. Die Prozedur muss mit einem dreiteiligen Namen ausgeführt werden, wenn es sich bei der aktuellen Datenbank nicht um die msdb-Datenbank handelt.

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. Wenn diesem Profil nicht gesendete Nachrichten zugeordnet sind, wird ein Fehler ausgelöst, und das Profil wird nicht gelöscht.

EXECUTE msdb.dbo.sysmail_delete_profile_sp
    @profile_name = N'AdventureWorks Administrator' 
    ,@force_delete = 0;

Siehe auch

Änderungsverlauf

Version	Verlauf
12. Dezember 2006	Neuer Inhalt: Der neue Parameter @force_delete wurde den Syntax-, Argument- und Beispielabschnitten hinzugefügt.

Freigeben über