Freigeben über

  • Artikel

sysmail_help_profile_sp (Transact-SQL)

Führt Informationen zu mindestens einem Mailprofil auf.

Themenlink (Symbol)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 und hat den Standardwert NULL.

  • [ @profile_name = ] 'profile_name'
    Der Profilname, zu dem Informationen zurückgegeben werden sollen. profile_name ist vom Datentyp sysname und hat den Standardwert 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.