NameSpace.Logon-Methode (Outlook)

Artikel
04/07/2023

Meldet den Benutzer bei MAPI an und eröffnet die MAPI-Sitzung.

Syntax

Ausdruck. Logon( _Profile_ , _Password_ , _ShowDialog_ , _NewSession_ )

Ausdruck Eine Variable, die ein NameSpace-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
Profile	Optional	Variant	Der MAPI-Profilname als String, der für die Sitzung verwendet werden soll. Geben Sie eine leere Zeichenfolge an, um das Standardprofil für die neue Sitzung zu verwenden.
Password	Optional	Variant	Das Kennwort (falls vorhanden) als Zeichenfolge, das dem Profil zugeordnet ist. Dieser Parameter dient nur der Abwärtskompatibilität und sollte aus Sicherheitsgründen nicht verwendet werden. Microsoft Outlook fordert den Benutzer auf, in den meisten Systemkonfigurationen ein Kennwort anzugeben. Dies ist Ihr Anmeldekennwort und sollte nicht mit dem PST-Kennwort verwechselt werden.
ShowDialog	Optional	Variant	True, um das MAPI-Anmeldedialogfeld anzuzeigen, sodass der Benutzer ein MAPI-Profil auswählen kann.
NewSession	Optional	Variant	True, um eine neue Outlook-Sitzung zu erstellen. Da in Outlook nicht mehrere Sitzungen erstellt werden können, sollte dieser Parameter nur dann als True festgelegt werden, wenn noch keine Sitzung vorhanden ist.

Hinweise

Verwenden Sie die Anmeldemethode nur, um sich bei einem bestimmten Profil anzumelden, wenn Outlook noch nicht ausgeführt wird. Grund dafür ist, dass nur einen Outlook-Prozess ausführen kann und dass dieser Outlook-Prozess nur ein Profil verwendet und nur eine MAPI-Sitzung unterstützt. Wenn Benutzer Outlook ein zweites Mal starten, wird diese Instanz von Outlook innerhalb desselben Outlook-Prozesses ausgeführt, sie erstellt keinen neuen Prozess und verwendet das gleiche Profil.

Wenn Outlook bereits ausgeführt wird, wird mit dieser Methode keine neue Outlook-Sitzung erstellt oder das aktuelle Profil in ein anderes geändert.

Wenn Outlook nicht ausgeführt wird und Sie Outlook nur mit dem Standardprofil starten möchten, verwenden Sie nicht die Anmeldemethode . Im folgenden Codebeispiel wird eine bessere Alternative gezeigtInitializeMAPI: starten Sie zunächst, das Outlook Anwendungsobjekt, und klicken Sie dann auf einen Standardordner, z. B. Posteingang. So wird MAPI mit dem Standardprofil gestartet und das Objektmodell ist voll funktionsfähig.

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

Wenn Sie ab Outlook 2010 über mehrere Profile verfügen, Sie Outlook so konfiguriert haben, dass immer ein Standardprofil verwendet wird, und Sie die Anmeldemethode verwenden, um sich beim Standardprofil anzumelden, ohne den Benutzer dazu aufzufordern, wird der Benutzer trotzdem aufgefordert, ein Profil auszuwählen. Um dieses Verhalten zu vermeiden, verwenden Sie nicht die Anmeldemethode . Verwenden Sie stattdessen die im vorherigen InitializeMAPI Beispiel vorgeschlagene Problemumgehung.

Beispiel

In diesem Beispiel für Visual Basic für Anwendungen wird die Logon-Methode zur Anmeldung an einer neuen Sitzung verwendet, wobei das Dialogfeld angezeigt wird, um den Profilnamen zu bestätigen und das Kennwort einzugeben.

Sub StartOutlook() 
    Dim myNameSpace As Outlook.NameSpace 
  
    Set myNameSpace = Application.GetNamespace("MAPI") 
    myNameSpace.Logon "LatestProfile", , True, True 
End Sub

Siehe auch

NameSpace-Objekt

Anleitung: Abrufen und Anmelden bei einer Instanz von Outlook

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Freigeben über