• Artykuł

sysmail_add_profile_sp (języka Transact-SQL)

Tworzy nowy profil poczty bazy danych.

Ostrzeżenie

Ponieważ baza danych poczty nie używa MAPI (MAPI), profile poczty bazy danych nie są profile MAPI poczty.Poczta bazy danych nie są używane profile poczty SQL .

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
    [ , [ @description = ] 'description' ]
    [ , [ @profile_id = ] new_profile_id OUTPUT ]

Argumenty

  • [ @ nazwa_profilu =] 'profile_name"
    Nazwa nowego profilu.profile_namejest sysname, z braku domyślne.

  • [ Opis @ =] 'description"
    Opcjonalny opis nowego profilu.descriptionjest nvarchar(256), z braku domyślne.

  • [ @ profile_id =] new_profile_iddanych wyjściowych
    Zwraca identyfikator dla nowego profilu.new_profile_idjest int, domyślna wartość NULL.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Uwagi

Profil poczty bazy danych przechowuje dowolną liczbę kont pocztowych bazy danych.Procedury pocztę przechowywaną w bazie danych można znaleźć profilu przez nazwę profilu lub identyfikator profilu wygenerowany przez tę procedurę.Aby uzyskać więcej informacji na temat dodawania konta do profilu, zobacz sysmail_add_profileaccount_sp (języka Transact-SQL).

Nazwa profilu i opis można zmienić z procedura składowana sysmail_update_profile_sp, podczas gdy identyfikator profilu pozostaje stała życia profilu.

Nazwa profilu musi być unikatowa dla programu Microsoft Aparat baz danych programu SQL Server lub procedura składowana zwraca błąd.

procedura składowanasysmail_add_profile_sp w msdb bazy danych i jest w posiadaniu dbo schematu. Procedury muszą być wykonane z nazwą trzech części, jeśli bieżąca baza danych nie jest msdb.

Uprawnienia

Uprawnienia domyślne tej procedury do członków wykonywania sysadmin stała rola serwera.

Przykłady

A.Tworzenie nowego profilu

Poniższy przykład tworzy nowy profil poczty bazy danych o nazwie AdventureWorks2008R2 Administrator.

EXECUTE msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks2008R2 Administrator',
       @description = 'Profile used for administrative mail.' ;

B.Tworzenie nowego profilu zapisywania id profilu w zmiennej

Poniższy przykład tworzy nowy profil poczty bazy danych o nazwie AdventureWorks Administrator.Przykład numeru identyfikatora profilu są przechowywane w zmiennej @profileId i zwraca zestaw wyników zawierający numer id profilu do nowego profilu.

DECLARE @profileId INT ;

EXECUTE msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks2008R2 Administrator',
       @description = 'Profile used for administrative mail.',
       @profile_id = @profileId OUTPUT ;

SELECT @profileId ;