sysmail_delete_profile_sp (Transact-SQL)

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. 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.

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

Siehe auch

Verweis

Konzepte