Partager via

_NameSpace.Logon(Object, Object, Object, Object) Méthode

  • Référence

Définition

Espace de noms:
Microsoft.Office.Interop.Outlook
Assembly:
Microsoft.Office.Interop.Outlook.dll

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.

S’applique à