xp_startmail (Transact-SQL)

Uruchamia sesja klient poczty SQL.Uruchamianie sesja poczty otwiera składniki klient MAPI i loguje się do serwera poczty e-mail.

Uwaga

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.

Topic link iconKonwencje składni języka Transact-SQL

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

Argumenty

  • [ @user = ] 'mapi_profile_name'
    Is an optional parameter specifying a mail profile name.mapi_profile_nameis sysname, with no default.Jeśli ten parametr nie zostanie podana, następnie domyślnie skonfigurowane w Microsoft Program Outlook jest używany.

  • [ @password = ] 'mapi_profile_password'
    Is the mail password for the specified mapi_profile_name.mapi_profile_password is sysname, with no default.Wartość NULL jest dozwolony po uruchomieniu klient poczty e-mail (na tym samym komputerze) przed uruchomieniem xp_startmail.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Zestawy wyników

xp_startmail zwraca tę wiadomość:

SQL mail session started.

Remarks

Jeśli mapi_profile_name i mapi_profile_password dostępne są SQL Server próbuje zalogować się do dostawca MAPI, korzystając z tego profilu nazwy i hasła. Jeśli mapi_profile_name i mapi_profile_password dostępne są, ale nie są poprawne, zwracany jest komunikat o błędzie. Jeśli mapi_profile_name i mapi_profile_password nie są dostępne, SQL Server używa to nazwa profilu użytkownika i hasło określone w Konfiguracja poczty SQL -okno dialogowe.Jeśli nie nazwy profilu lub hasło jest jawnie, SQL Server próbuje zalogować się do dostawca MAPI, przy użyciu domyślnego profilu MAPI. Niektórzy dostawcy MAPI może być skonfigurowany do korzystania z uwierzytelnianie systemu Windows, w których przypadek hasło MAPI jest ignorowana.

Uwaga

Jeśli używasz xp_startmail uruchomić swoje sesje, użytkownik może opcjonalnie wpisz swoją nazwę logowania i hasło, dzięki czemu nie trzeba go wpisać w wiersz polecenia.Jednak SQL poczta nie będzie działać na górze do istniejącej sesja MAPI, jeśli jednym jest uruchomiony.To zachowanie różni się od SQL Server w wersja 7.0 lub starszym.

Jeśli do istniejącej sesja poczty xp_startmail nie można uruchomić nowej.Jeśli na tym samym komputerze, na którym jest używany poczty SQL Server jest także uruchomiona, klient poczty musi być uruchomiona przed xp_startmail jest lub wykonywania, przed SQL Server zostanie uruchomiony, jeśli SQL poczty jest skonfigurowany do uruchamiania automatycznego podczas SQL Server zostanie uruchomiony.

Uprawnienia

Członkostwo w grupie wymaga sysadmin ustalić roli serwera, ale inni użytkownicy mogą być przyznane uprawnienia wykonać.Ze względów bezpieczeństwa zaleca się jednak że uprawnienia dla tej procedura przechowywana jest ograniczona do członków sysadmin ustalić roli serwera.

Przykłady

W poniższym przykładzie uruchamia poczty przy użyciu nazwy użytkownika i hasło określone w Microsoft Program Outlook jako profil domyślny dla Microsoft Konta systemu Windows, które SQL Server działa jako.

USE master;
GO
EXEC xp_startmail;
GO