xp_startmail (Transact-SQL)
SQL Mail bir istemci oturumunu başlatır.MAPI istemci bileşenlerini açar ve e-posta sunucusuna oturum açtığında bir posta oturumu başlatılıyor.
Not
This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.
.gif "Topic link icon")
xp_startmail [ [ @user= ] 'mapi_profile_name' ]
[ , [ @password= ] 'mapi_profile_password' ]
Bağımsız değişkenler
[ @user = ] 'mapi_profile_name'
Is an optional parameter specifying a mail profile name.mapi_profile_nameis sysname, with no default.Bu parametre sağlanmazsa, sonra varsayılan yapılandırılmış Microsoft Outlook kullanılır.[ @password = ] 'mapi_profile_password'
Is the mail password for the specified mapi_profile_name.mapi_profile_password is sysname, with no default.(Aynı bilgisayarda) bir posta istemcisi başlatıldığında önce çalışan NULL değerine izin verilir xp_startmail.
Dönüş Kodu Değerleri
0 (başarılı) veya 1 (hata)
Sonuç Kümeleri
xp_startmail bu iletisini döndürür:
SQL mail session started.
Remarks
If mapi_profile_name ve mapi_profile_password , sağlanan SQL Server Bu profil adı ve parola kullanarak MAPI sağlayıcı için oturum açma girişiminde bulunur. If mapi_profile_name ve mapi_profile_password sağlanır, ancak yanlış hata iletisi döndürdü. If mapi_profile_name ve mapi_profile_password , sağlanmamış olan SQL Server Profil adı ve parola belirtilen SQL posta yapılandırması iletişim kutusu.Herhangi bir profil adı veya parola açıkça, sağlanıyorsa SQL Server MAPI sağlayıcı için varsayılan MAPI profilini kullanarak oturum açmaya çalışır. Bazı MAPI sağlayıcıların Windows kimlik doğrulaması, Durum MAPI parolası göz ardı kullanacak biçimde yapılandırılmış olabilir.
Not
Kullanıyorsanız xp_startmail sizin posta oturumu başlatmak için komut istemi isteminde yazılacak olması için isteğe bağlı olarak, oturum açma adı ve parola sağlayabilirsiniz.Ancak, SQL Mail birini çalıştırıyorsa, varolan bir MAPI oturum üstünde çalışmayacak.Bu davranış farklı SQL Server sürüm 7.0 ve önceki.
Varolan bir posta oturum ise xp_startmail yeni bir başlatılmaz.Posta, aynı bilgisayarda kullanılmakta ise SQL Server de çalışıyor olan posta istemcisi olmalı ya da önce başlatıldı. xp_startmail veya önce çalışmasını, olur.SQL Server SQL Mail otomatik olarak başlatılacak biçimde yapılandırılmışsa, başlatıldı, SQL Server başlatır.
İzinler
Üyelik gerektirir sysadmin sabit sunucu rolü, ancak yürütmek izinleri, diğer kullanıcılar için verilebilir.Ancak, güvenlik nedenleriyle Bu saklı yordam için izinleri üyelerine sınırlı olmasını öneririz sysadmin sabit sunucu rolü.
Örnekler
Aşağıdaki örnek, kullanıcı adı kullanarak posta başlatır ve belirtilen parola Microsoft Outlook için varsayılan profil olarak Microsoft Windows, hesap SQL Server olarak çalışır.
USE master;
GO
EXEC xp_startmail;
GO