Share via


sysmail_add_profile_sp (Transact-SQL)

Yeni bir veritabanı posta profili oluşturur.

Not

Veritabanı posta İleti Uygulama Programı arabirim (MAPI) kullandığı için veritabanı posta profilleri MAPI posta profillerini değildir.Veritabanı posta SQL posta profilleri kullanın.

Topic link iconTransact-SQL sözdizimi kuralları

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

Bağımsız değişkenler

  • [ @ profile_name = ] 'profile_name'
    The name for the new profile.profile_name is sysname, with no default.

  • [ @ açıklaması= ] 'description'
    The optional description for the new profile.description is nvarchar(256), with no default.

  • [ @profile_id = ] new_profile_idOUTPUT
    Returns the ID for the new profile.new_profile_id is int, with a default of NULL.

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (hata)

Remarks

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

Profil adı ve açıklaması ile değiştirilebilir saklı yordam sysmail_update_profile_spprofil kimliği profilin ömrü için sabit kalır, ancak.

Profil adı Microsoft benzersiz olmalıdır. SQL Server Database Engine veya saklı yordamı bir hata döndürür.

Saklı yordam sysmail_add_profile_sp is in the msdb veritabanı ve tarafından sahibidbo şema.Geçerli veritabanı değilse, üç bölümlü bir adla yordamı yürütülmelidir msdb.

İzinler

yürütmek izinleri için bu yordamı varsayılan üyelere sysadmin sabit sunucu rolü.

Örnekler

C.Creating a new profile

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

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

b.Creating a new profile, saving the profile id in a variable

Aşağıdaki örnek, adlı yeni bir veritabanı posta profili oluşturur. AdventureWorks Administrator. Örnek profil kimliği numarası değişkende depolar. @profileId ve sonuç yeni profil için profil kimliği numarasını içeren kümesini döndürür.

DECLARE @profileId INT ;

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

SELECT @profileId ;