Share via


sysmail_add_profile_sp (Transact-SQL)

Yeni bir veritabanı posta profili oluşturur.

Not

Database Mail İleti Uygulama Programı Arabirimi (MAPI) kullanmaz çünkü veritabanı posta profili MAPI posta profillerini değildir.Database Mail'i SQL posta profilleri kullanmaz.

Konu bağlantısı simgesiTransact-SQL sözdizimi kuralları

Sözdizimi

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

Bağımsız değişkenler

  • [ @ Profil_adı =] 'profile_name'
    Yeni profilin adı.profile_nameİş sysname, ile hiçbir varsayılan.

  • [ @ description =] 'description'
    Yeni profil için isteğe bağlı bir açıklama.descriptionİş nvarchar(256), ile hiçbir varsayılan.

  • [ @ profile_id =] new_profile_idÇıkış
    Yeni profilin Kimliği döndürür.new_profile_idİş int, varsayılan değer null.

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (başarısız)

Açıklamalar

Bir veritabanı posta profili herhangi bir sayıda veritabanı posta hesaplarını tutar.Veritabanı posta profil adı veya bu yordamla oluşturulan profil kimliği saklı yordamlar profile başvuru yapabilirsiniz.Firma profili ekleme hakkında daha fazla bilgi için bkz: sysmail_add_profileaccount_sp (Transact-SQL).

Profil adı ve açıklaması saklı yordamdeğiştirilebilirsysmail_update_profile_sp, profil kimliği sabit profil ömrü kaldığı sürece.

Profil adı Microsoft benzersiz SQL Server Veritabanı Altyapısı veya saklı yordam döndürür bir hata.

saklı yordamsysmail_add_profile_sp içinde msdb veritabanı ve sahibi dbo şema. Geçerli veritabanı değilse, yordamı üç bölümlü adı ile yürütülmelidir msdb.

İzinler

Yürütme izinleri için bu yordamı varsayılan üyelerine sysadmin sabit sunucu rolü.

Örnekler

A.Yeni bir profil oluşturma

Aşağıdaki örnek, adlı yeni bir veritabanı posta profili oluşturur AdventureWorks2008R2 Administrator.

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

B.Profil Kimliği bir değişkende kaydetme, yeni bir profil oluşturma

Aşağıdaki örnek, adlı yeni bir veritabanı posta profili oluşturur AdventureWorks Administrator.Örnek Profil Kimliği numarası değişkende saklar @profileId ve bir sonuç kümesi içeren profili kimlik numarası için yeni bir profil.

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 ;