xp_startmail (Transact-SQL)
Démarre une session client SQL Mail. Le démarrage d'une session de messagerie provoque l'ouverture des composants clients MAPI et la connexion au serveur de messagerie.
Notes
Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.
.gif "Icône Lien de rubrique")
Syntaxe
xp_startmail [ [ @user= ] 'mapi_profile_name' ]
[ , [ @password= ] 'mapi_profile_password' ]
Arguments
[ @user = ] 'mapi_profile_name'
Paramètre facultatif spécifiant un nom de profil de messagerie. mapi_profile_name est de type sysname, sans valeur par défaut. Si ce paramètre n'est pas spécifié, la valeur par défaut configurée dans Microsoft Outlook est utilisée.[ @password = ] 'mapi_profile_password'
Mot de passe de messagerie pour la valeur mapi_profile_name spécifiée. mapi_profile_password est de type sysname, sans valeur par défaut. Une valeur NULL est autorisée lorsque le client de messagerie électronique est démarré (sur le même ordinateur) avant d'exécuter xp_startmail.
Valeurs des codes renvoyés
0 (succès) ou 1 (échec)
Jeux de résultats
xp_startmail renvoie le message suivant :
SQL mail session started.
Notes
Si mapi_profile_name et mapi_profile_password sont spécifiés, SQL Server essaie de se connecter au fournisseur MAPI à l'aide de ce nom de profil et de ce mot de passe. Si mapi_profile_name et mapi_profile_password sont spécifiés mais incorrects, un message d'erreur est renvoyé. Si mapi_profile_name et mapi_profile_password sont omis, SQL Server utilise le nom de profil et le mot de passe définis dans la boîte de dialogue Configuration de SQL Mail. Si aucun nom de profil ou mot de passe n'est explicitement fourni, SQL Server essaie de se connecter au fournisseur MAPI à l'aide du profil MAPI par défaut. Vous pouvez configurer certains fournisseurs MAPI afin qu'ils utilisent l'authentification Windows, auquel cas le mot de passe MAPI est ignoré.
Notes
Si vous utilisez xp_startmail pour démarrer vos sessions de messagerie, vous avez la possibilité d'indiquer votre nom de connexion et votre mot de passe dans cette boîte de dialogue, ce qui vous évitera de devoir le faire sur la ligne de commande. Toutefois, SQL Mail ne viendra pas se superposer à une session MAPI existante si une telle session est en cours d'exécution. Ce comportement diffère de celui de la version 7.0 de SQL Server et des versions antérieures.
S'il existe une session de messagerie, xp_startmail n'en démarre pas de nouvelle. Si la messagerie électronique est utilisée sur le même ordinateur que celui où est exécuté SQL Server, le client de messagerie électronique doit être démarré avant d'utiliser xp_startmail ou avant de démarrer SQL Server si SQL Mail est configuré pour démarrer automatiquement en même temps que SQL Server.
Autorisations
Nécessite l'appartenance au rôle de serveur fixe sysadmin, mais les autorisations EXECUTE peuvent être accordées à d'autres utilisateurs. Cependant, pour des raisons de sécurité, nous vous conseillons de limiter les autorisations pour cette procédure stockée aux membres du rôle de serveur fixe sysadmin.
Exemple
L'exemple suivant démarre la messagerie électronique en utilisant le nom d'utilisateur et le mot de passe spécifiés dans Microsoft Outlook au titre de profil par défaut du compte Microsoft Windows sous lequel s'exécute SQL Server.
USE master;
GO
EXEC xp_startmail;
GO