sysmail_help_principalprofile_sp (Transact-SQL)

Aktualisiert: 12. Dezember 2006

Führt Informationen zu Zuordnungen zwischen Datenbank-E-Mail-Profilen und msdb-Datenbankprinzipalen auf.

Transact-SQL-Syntaxkonventionen

Syntax

sysmail_help_principalprofile_sp [ {   [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ]
    [ [ , ] {   [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ]

Argumente

• [ @principal_id= ] principal_id
  Entspricht der ID des msdb-Datenbankbenutzers bzw. 0 für die public-Rolle. principal_id entspricht int, der Standardwert lautet NULL. Es kann entweder principal_id oder principal_name angegeben werden.

• [ @principal_name= ] 'principal_name'
  Entspricht dem Namen des msdb-Datenbankbenutzers oder 'public' für die public-Rolle. principal_name entspricht sysname, der Standardwert lautet NULL. Es kann entweder principal_id oder principal_name angegeben werden.

• [ @profile_id= ] profile_id
  Die Profil-ID der Zuordnung, die aufgelistet werden soll. profile_id ist vom Datentyp int, der Standardwert ist NULL. Es kann entweder profile_id oder profile_name angegeben werden.

• [ @profile_name= ] 'profile_name'
  Der Name des Profils für die Zuordnung, die aufgelistet werden soll. profile_name ist vom Datentyp sysname, der Standardwert ist NULL. Es kann entweder profile_id oder profile_name angegeben werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Gibt ein Resultset zurück, das die in der folgenden Tabelle aufgelisteten Spalten enthält.

Hinweise

Wird sysmail_help_principalprofile_sp ohne Parameter aufgerufen, werden im zurückgegebenen Resultset alle Zuordnungen in der Instanz von SQL Server aufgelistet. Andernfalls enthält das Resultset Informationen zu Zuordnungen, die mit den bereitgestellten Parametern übereinstimmen. So listet beispielsweise die Prozedur alle Zuordnungen für ein Profil auf, wenn der Profilname bereitgestellt wird.

sysmail_help_principalprofile_sp wird in der msdb-Datenbank gespeichert und befindet sich im Besitz des dbo-Schemas. Die Prozedur muss mithilfe eines dreiteiligen Namens ausgeführt werden, wenn es sich bei der aktuellen Datenbank nicht um msdb handelt.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle sysadmin.

Beispiele

A. Auflisten von Informationen für eine bestimmte Zuordnung

Im folgenden Beispiel werden die Informationen für alle Zuordnungen zwischen dem Profil AdventureWorks Administrator und dem Prinzipal ApplicationLogin in der msdb-Datenbank aufgelistet.

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp
    @principal_name = 'danw',
    @profile_name = 'AdventureWorks Administrator' ;

Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde.

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
5            danw               9           AdventureWorks Administrator   1

B. Auflisten von Informationen für alle Zuordnungen

Im folgenden Beispiel werden die Informationen für alle Zuordnungen in der Instanz aufgelistet.

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp ;

Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde.

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
6            terrid             3           Product Update Profile         1
5            danw               9           AdventureWorks Administrator   1

Siehe auch

Verweis

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

Andere Ressourcen

Datenbank-E-Mail
Konfigurationsaufgabe auswählen (Datenbank-E-Mail)

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf