_NameSpace.Logon(Object, Object, Object, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Connecte l'utilisateur à l'interface MAPI, ce qui ouvre une session MAPI.
public void Logon (object Profile, object Password, object ShowDialog, object NewSession);
Public Sub Logon (Optional Profile As Object, Optional Password As Object, Optional ShowDialog As Object, Optional NewSession As Object)
Paramètres
- Profile
- Object
Nom du profil MAPI, sous la forme d’une chaîne (chaîne en C#), à utiliser pour la session. Spécifiez une chaîne vide pour utiliser le profil par défaut pour la session actuelle.
- Password
- Object
Mot de passe (le cas échéant), sous la forme d’une chaîne (chaîne en C#), associée au profil. Ce paramètre n'est fourni que pour assurer la compatibilité descendante et il est préférable, pour des raisons de sécurité, de ne pas l'utiliser. Microsoft Outlook invite l’utilisateur à spécifier un mot de passe dans la plupart des configurations système. Il s'agit de votre mot de passe d'ouverture de session, qui ne doit pas être confondu avec les mots de passe PST.
- ShowDialog
- Object
True pour afficher la boîte de dialogue d'ouverture de session MAPI qui permet à l'utilisateur de sélectionner un profil MAPI.
- NewSession
- Object
True pour créer une session Outlook. Puisque vous ne pouvez pas créer plusieurs sessions dans Outlook, ce paramètre doit être True uniquement s'il n'existe pas encore de session.
Remarques
Utilisez la méthode Logon uniquement pour vous connecter à un profil spécifique quand Outlook n’est pas déjà en cours d’exécution. En effet, seul un processus Outlook peut être exécuté à la fois, et ce processus Outlook n'utilise qu'un seul profil et ne prend en charge qu'une seule session MAPI. Lorsqu’un utilisateur démarre Outlook une deuxième fois, cette instance d’Outlook s’exécute dans le même processus Outlook, ne crée pas de nouveau processus et utilise le même profil.
Si Outlook est en cours d'exécution, le fait d'utiliser cette méthode ne crée pas de nouvelle session Outlook et ne change pas le profil actif.
Si Outlook n’est pas en cours d’exécution et que vous souhaitez uniquement démarrer Outlook avec le profil par défaut, n’utilisez pas la méthode Logon . L’exemple de code InitializeMAPI suivant présente une meilleure alternative : tout d’abord, instanciez l’objet Outlook Application , puis référencez un dossier par défaut tel que la boîte de réception. Cela a pour effet parallèle d'initialiser MAPI de manière à utiliser le profil par défaut et à rendre le modèle objet pleinement fonctionnel.
Imports Outlook = Microsoft.Office.Interop.Outlook
Sub InitializeMAPI ()
' Start Outlook.
Dim olApp As Outlook.Application
Set olApp = CreateObject("Outlook.Application")
' Get a session object.
Dim olNs As Outlook.NameSpace
Set olNs = olApp.GetNamespace("MAPI")
' Create an instance of the Inbox folder.
' If Outlook is not already running, this has the side
' effect of initializing MAPI.
Dim mailFolder As Outlook.Folder
Set mailFolder = olNs.GetDefaultFolder(olFolderInbox)
' Continue to use the object model to automate Outlook.
End Sub
À compter d’Outlook 2010, si vous avez plusieurs profils, que vous avez configuré Outlook pour qu’il utilise toujours un profil par défaut et que vous utilisez la méthode Logon pour vous connecter au profil par défaut sans inviter l’utilisateur, l’utilisateur reçoit quand même une invite à choisir un profil. Pour éviter ce problème, n’utilisez pas la méthode Logon ; utilisez la solution de contournement suggérée dans l’exemple InitializeMAPI précédent.