Artykuł
07/26/2011

xp_startmail (języka Transact-SQL)

Uruchamia klientpoczty SQLsesja. Uruchamianie poczty sesja otwiera składnikiklient MAPIi loguje się do serwera poczty e-mail.

Ostrzeżenie

Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Należy unikać stosowania tej funkcji w nowych projektach oraz zaplanować modyfikację aplikacji, w których obecnie jest używana ta funkcja.

Ikona łącza do tematu Języka Transact-SQL składni konwencje

Składnia

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

Argumenty

[ @user = ] 'mapi_profile_name'
To parametr opcjonalny określający nazwę profilu poczty.mapi_profile_namejest sysname, z braku domyślne.Jeżeli nie podano tego parametru, a następnie domyślnie skonfigurowane w Microsoft program Outlook jest używany.
[ @ hasło = ] 'mapi_profile_password"
To hasło poczty określonego mapi_profile_name.mapi_profile_passwordjest sysname, z braku domyślne.Wartość NULL jest dozwolony po uruchomieniu klient poczty (na tym samym komputerze) przed uruchomieniem xp_startmail.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Zestawy wyników

xp_startmail zwraca ten komunikat:

SQL mail session started.

Uwagi

Jeśli mapi_profile_name i mapi_profile_password dostępne są SQL Server próbuje zalogować się dodostawca MAPI, korzystając z tego profilu, nazwę i hasło. Jeśli mapi_profile_name i mapi_profile_password są dostępne, ale są nieprawidłowe, zwracany jest komunikat o błędzie.Jeśli mapi_profile_name i mapi_profile_password nie są dostarczane, SQL Server używa nazwy profilu i hasło określone w Konfiguracja pocztySQL okno dialogowe.Jeśli nie nazwa profilu lub hasło jest jawnie, SQL Server próbuje zalogować się do MAPI dostawca przy użyciu profilu MAPI domyślnych.Niektórzy dostawcy MAPI może być skonfigurowany do używania uwierzytelniania systemu Windows, w którym przypadek hasło MAPI jest ignorowana.

Ostrzeżenie

Jeśli używasz xp_startmail do rozpoczęcia sesji poczty, opcjonalnie podać nazwę logowania i hasło, dzięki czemu nie trzeba wpisywać w wiersz polecenia.Jednak SQL poczty nie będzie działać na górze istniejącejsesja MAPI, jeśli jest uruchomiony jeden. To zachowanie różni się od SQL Server wersja 7.0 i wcześniejszych.

Jeśli do istniejącej korespondencji sesja xp_startmail nie można uruchomić nową.Jeżeli poczta jest używany na tym samym komputerze, na którym SQL Server jest również uruchomiona klient poczty musi być uruchomiona przed xp_startmail jest uruchamiany lub przed SQL Server jest uruchomiona, jeśli SQL poczty jest skonfigurowany do automatycznego uruchamiania podczas SQL Server uruchomieniu.

Uprawnienia

Wymaga członkostwa w sysadmin stała rola serwera, ale uprawnienia wykonywania mogą być przyznane innym użytkownikom.Jednak ze względów bezpieczeństwa zalecane jedynie uprawnienia dla tej procedura składowana dla członków sysadmin stała rola serwera.

Przykłady

W następującym przykładzie uruchomiono poczty przy użyciu nazwy użytkownika i hasło określone w Microsoft programu Outlook jako domyślnego profilu dla Microsoft konta systemu Windows SQL Server działa jako.