Share via


xp_startmail (Transact-SQL)

SQL Mail istemcioturumbaşlatır. Posta oturum başlatmadan MAPI istemci bileşenlerini açar ve e-posta sunucusuna oturum açar.

Not

Bu özellik Microsoft SQL Server'ın ilerideki bir sürümünde kaldırılacaktır. Yeni geliştirme işlerinde bu özelliği kullanmaktan kaçının ve bu özelliği kullanmakta olan uygulamalarda değişiklik yapmayı planlayın.

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

Sözdizimi

xp_startmail [ [ @user= ] 'mapi_profile_name' ]
     [ , [ @password= ] 'mapi_profile_password' ] 

Bağımsız değişkenler

  • [ @user = ] 'mapi_profile_name'
    Posta profil adını belirten isteğe bağlı bir parametre.mapi_profile_nameİş sysname, ile hiçbir varsayılan.Bu parametre girilmediği sonra varsayılan yapılandırılmış Microsoft Outlook kullanılır.

  • [ parola @ = ] 'mapi_profile_password'
    Belirtilen posta parolası mapi_profile_name.mapi_profile_passwordİş sysname, ile hiçbir varsayılan.(Aynı bilgisayarda) posta istemci başlatıldığında bir null değeri çalıştırmadan önce izin xp_startmail.

Dönüş Kodu Değerleri

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

Sonuç Kümeleri

xp_startmail bu iletiyi döndürür:

SQL mail session started.

Açıklamalar

mapi_profile_name Ve mapi_profile_password sağlanan, SQL Server çalıştığında oturum MAPIsağlayıcı kullanarak bu profil adı ve parola. mapi_profile_name Ve mapi_profile_password sağlanır, ancak yanlış bir hata iletisi döndürülür.mapi_profile_name Ve mapi_profile_password değil sağlanır, SQL Server Profil adı ve belirtilen parola kullanan SQL Mail yapılandırma iletişim kutusu.Profil adı ya da parola açıkça belirtilmezse, SQL Server MAPIsağlayıcı kullanarak oturum çalışır varsayılan MAPI profili.Bazı MAPI sağlayıcıların durum MAPI parola gözardı edilir Windows kimlik doğrulaması kullanacak şekilde yapılandırılmış olabilir.

Not

Kullanırsanız, xp_startmail komut istemiyazın gerekmez böylece sizin posta oturumu başlatmak için size isteğe bağlı oturum açma adınızı ve parolanızı sağlayabilir.Ancak, SQL Mail biri çalışıyorsa, varolan bir MAPI oturum üstünde çalışmaz.Bu davranışı farklıdır SQL Server sürüm 7.0 ve daha önceki.

Varolan bir posta oturumise xp_startmail yeni bir başlangıç değil.Posta, aynı bilgisayarda kullanılıp kullanılmadığını SQL Server de çalışıyor ise posta istemci olmalıdır önce başlatılan xp_startmail çalıştırılan veya daha önce SQL Server SQL Mail otomatik olarak başlatılacak biçimde yapılandırılmışsa başladı, SQL Server başlar.

İzinler

Üyelik gerektiren sysadmin sabit sunucu rolüancak yürütme izinleri diğer kullanıcılara verilir.Ancak, güvenlik nedenleriyle, bu saklı yordam izinlerini üyelerine sınırlı ö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 as çalışır

USE master;
GO
EXEC xp_startmail;
GO