xp_startmail (Transact-SQL)
Avvia una sessione del client SQL Mail. All'avvio di una sessione di posta elettronica vengono aperti i log e viene eseguito l'accesso al server di posta elettronica.
[!NOTA]
Questa caratteristica verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Evitare di utilizzare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata.
.gif "Icona di collegamento a un argomento")
Sintassi
xp_startmail [ [ @user= ] 'mapi_profile_name' ]
[ , [ @password= ] 'mapi_profile_password' ]
Argomenti
[ @user = ] 'mapi_profile_name'
Parametro facoltativo che specifica il nome di un profilo utente di posta elettronica. mapi_profile_nameè di tipo sysname e non prevede alcun valore predefinito. Se questo parametro non viene specificato, viene utilizzato il valore predefinito configurato in Microsoft Outlook.[ @password = ] 'mapi_profile_password'
Password di posta elettronica per il valore specificato in mapi_profile_name. mapi_profile_password è di tipo sysname e non prevede alcun valore predefinito. Il valore NULL è consentito quando il client di posta elettronica viene avviato nello stesso computer prima di eseguire xp_startmail.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Set di risultati
La stored procedure xp_startmail restituisce il messaggio seguente:
SQL mail session started.
Osservazioni
Se i parametri mapi_profile_name e mapi_profile_password vengono specificati, SQL Server tenta di accedere al provider MAPI utilizzando il nome e la password del profilo specificati. Se i parametri mapi_profile_name e mapi_profile_password vengono specificati ma non sono corretti, viene restituito un messaggio di errore. Se i parametri mapi_profile_name e mapi_profile_password non vengono specificati, SQL Server utilizza il nome e la password del profilo immessi nella finestra di dialogo Configurazione SQL Mail. Se non viene specificato alcun profilo utente o password in modo esplicito, viene eseguito un tentativo di accesso SQL Server al provider MAPI in base al profilo MAPI predefinito. Alcuni provider MAPI sono configurati per l'utilizzo dell'autenticazione di Windows. In tal caso, la password MAPI viene ignorata.
[!NOTA]
Se si utilizza xp_startmail per avviare le sessioni di posta elettronica, è possibile specificare il proprio account di accesso e la propria password in modo da non doverli digitare al prompt dei comandi. SQL Mail non potrà essere eseguito se una sessione MAPI è già in corso. Questo comportamento rappresenta una differenza rispetto a SQL Server 7.0 e versioni precedenti.
Se è presente una sessione di posta elettronica, xp_startmail non avvia una nuova sessione. Se nel computer SQL Server è in uso la posta elettronica, il client di posta elettronica deve essere avviato prima dell'esecuzione di xp_startmail o dell'avvio di SQL Server se SQL Mail è configurato per l'avvio automatico con SQL Server.
Autorizzazioni
È richiesta l'appartenenza al ruolo predefinito del server sysadmin, ma è possibile concedere autorizzazioni EXECUTE ad altri utenti. Per motivi di protezione, è tuttavia consigliabile concedere le autorizzazioni per l'esecuzione di questa stored procedure solo ai membri del ruolo predefinito del server sysadmin.
Esempi
Nell'esempio seguente viene avviato il sistema di posta elettronica utilizzando il nome utente e la password specificati in Microsoft Outlook come profilo predefinito per l'account di Microsoft Windows con cui viene eseguito SQL Server.
USE master;
GO
EXEC xp_startmail;
GO