sysmail_help_principalprofile_sp (Transact-SQL)

Van toepassing op:SQL Server

Geeft informatie over associaties tussen Database Mail-profielen en databasehoofden.

Transact-SQL syntaxis-conventies

Syntax

dbo.sysmail_help_principalprofile_sp
    { [ @principal_id = ] principal_id
        | [ @principal_name = ] N'principal_name' }
    [ , [ @profile_id = ] profile_id ]
    [ , [ @profile_name = ] N'profile_name' ]
[ ; ]

Arguments

[ @principal_id = ] principal_id

De ID van de databasegebruiker of rol in de msdb database voor de associatie om te vermelden. @principal_id is int, met als standaard .NULL Zowel @principal_id als @principal_name moeten worden gespecificeerd.

[ @principal_name = ] N'principal_name'

De naam van de database gebruiker of rol in de msdb database voor de associatie die vermeld moet worden. @principal_name is sysname, met als standaard .NULL Zowel @principal_id als @principal_name moeten worden gespecificeerd.

[ @profile_id = ] profile_id

De ID van het profiel voor de vereniging om te vermelden. @profile_id is int, met een standaardwaarde van NULL. Zowel @profile_id als @profile_name kunnen worden gespecificeerd.

[ @profile_name = ] N'profile_name'

De naam van het profiel voor de vereniging om te vermelden. @profile_name is sysname, met een standaardwaarde van NULL. Zowel @profile_id als @profile_name kunnen worden gespecificeerd.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Resultaatset

Geeft een resultaatset terug die de kolommen bevat die in de volgende tabel zijn vermeld.

Kolomnaam Gegevenstype Description
principal_id int De ID van de databasegebruiker.
principal_name sysname De naam van de databasegebruiker.
profile_id int Het ID-nummer van het Database Mail-profiel.
profile_name sysname De naam van het Database Mail-profiel.
is_default bit De vlag die aangeeft of het profiel het standaardprofiel van de gebruiker is.

Remarks

Als sysmail_help_principalprofile_sp wordt aangeroepen zonder parameters, geeft de teruggegeven resultaatset alle associaties in de instantie van SQL Server weer op. Anders bevat de resultaatset informatie voor associaties die overeenkomen met de gegeven parameters. De procedure vermeldt bijvoorbeeld alle associaties voor een profiel wanneer de profielnaam wordt opgegeven.

sysmail_help_principalprofile_sp in de msdb database zit en eigendom is van het DBO-schema . De procedure moet worden uitgevoerd met een driedelige naam als de huidige database dat niet msdbis.

Permissions

Je kunt rechten verlenen EXECUTE op deze procedure, maar deze rechten kunnen worden overschreven tijdens een SQL Server-upgrade.

Examples

A. Lijstinformatie voor een specifieke vereniging

Het volgende voorbeeld toont een overzicht van de informatie voor alle associaties tussen het AdventureWorks Administrator profiel en de ApplicationLogin principal in de msdb database.

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

Hier is een voorbeeldresultaatset, opnieuw geformatteerd voor lijnlengte.

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

B. Lijstinformatie voor alle verenigingen

Het volgende voorbeeld toont een overzicht van de informatie voor alle associaties in het voorbeeld.

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp;

Hier is een voorbeeldresultaatset, opnieuw geformatteerd voor lijnlengte.

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