sysmail_help_profile_sp (Transact-SQL)
Gilt für: SQL Server
Führt Informationen zu mindestens einem Mailprofil auf.
Transact-SQL-Syntaxkonventionen
Syntax
sysmail_help_profile_sp [ [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' ]
[ ; ]
Argumente
[ @profile_id = ] profile_id
Die Profil-ID, für die Informationen zurückgegeben werden sollen. @profile_id ist int, mit einem Standardwert von NULL
.
[ @profile_name = ] 'profile_name'
Der Profilname, zu dem Informationen zurückgegeben werden sollen. @profile_name ist "sysname" mit der Standardeinstellung "NULL
.
Rückgabecodewerte
0
(erfolgreich) oder 1
Fehler.
Resultset
Gibt ein Resultset mit den folgenden Spalten zurück.
Spaltenname | Datentyp | BESCHREIBUNG |
---|---|---|
profile_id |
int | Die Profil-ID für das Profil. |
name |
sysname | Der Profilname des Profils. |
description |
nvarchar(256) | Die Beschreibung des Profils. |
Hinweise
Wenn ein Profilname oder eine Profil-ID angegeben wird, sysmail_help_profile_sp
werden Informationen zu diesem Profil zurückgegeben. sysmail_help_profile_sp
Andernfalls werden Informationen zu jedem Profil in der SQL Server-Instanz zurückgegeben.
Die gespeicherte Prozedur sysmail_help_profile_sp
befindet sich in der msdb
Datenbank und befindet sich im Besitz des dbo-Schemas . Die Prozedur muss mit einem dreiteiligen Namen ausgeführt werden, wenn die aktuelle Datenbank nicht msdb
vorhanden ist.
Berechtigungen
Sie können Berechtigungen für dieses Verfahren erteilen EXECUTE
, aber diese Berechtigungen können während eines SQL Server-Upgrades außer Kraft gesetzt werden.
Beispiele
A. Alle Profile auflisten
Im folgenden Beispiel werden alle Profile in der Instanz aufgelistet.
EXEC msdb.dbo.sysmail_help_profile_sp;
Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde:
profile_id name description
----------- ----------------------------- ------------------------------
56 AdventureWorks Administrator Administrative mail profile.
57 AdventureWorks Operator Operator mail profile.
B. Auflisten eines bestimmten Profils
Im folgenden Beispiel werden Informationen für das AdventureWorks Administrator
-Profil aufgelistet.
EXEC msdb.dbo.sysmail_help_profile_sp
@profile_name = 'AdventureWorks Administrator' ;
Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde:
profile_id name description
----------- ----------------------------- ------------------------------
56 AdventureWorks Administrator Administrative mail profile.