sysmail_help_profile_sp (Transact-SQL)

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, zu der Informationen zurückgegeben werden sollen. profile_id ist vom Datentyp int. Der Standardwert ist NULL.

• [ @profile_name = ] 'profile_name'
  Der Profilname, zu dem Informationen zurückgegeben werden sollen. profile_name ist vom Datentyp sysname. Der Standardwert ist NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Gibt ein Resultset mit den folgenden Spalten zurück.

Spaltenname	Datentyp	Beschreibung
profile_id	int	Die Profil-ID des Profils.
name	sysname	Der Profilname des Profils.
description	nvarchar(256)	Die Beschreibung des Profils.

Hinweise

Wenn ein Profilname oder eine Profil-ID angegeben ist, gibt sysmail_help_profile_sp Informationen zu diesem Profil zurück. Andernfalls gibt sysmail_help_profile_sp Informationen zu jedem Profil in der SQL Server-Instanz zurück.

Die gespeicherte Prozedur sysmail_help_profile_sp befindet sich in der msdb-Datenbank und im Besitz des dbo-Schemas. Handelt es sich bei der aktuellen Datenbank nicht um msdb, muss die Prozedur mit einem dreiteiligen Namen ausgeführt werden.

Berechtigungen

Die Ausführungsberechtigungen für diese Prozedur erhalten standardmäßig Mitglieder der festen Serverrolle sysadmin.

Beispiele

A. Auflisten aller Profile

Im folgenden Beispiel werden alle Profile in der Instanz aufgelistet.

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

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

Siehe auch

Verweis

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

Konzepte

Datenbank-E-Mail