_NameSpace.Logon(Object, Object, Object, Object) Methode

  • Referenz

Definition

Namespace:
Microsoft.Office.Interop.Outlook
Assembly:
Microsoft.Office.Interop.Outlook.dll

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

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)

Parameter

Profile
Object

Der MAPI-Profilname als Zeichenfolge (Zeichenfolge in C#), 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
Object

Das Kennwort (falls vorhanden) als Zeichenfolge (Zeichenfolge in C#), die 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
Object

True, um das MAPI-Anmeldedialogfeld anzuzeigen, sodass der Benutzer ein MAPI-Profil auswählen kann.

NewSession
Object

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 ein Benutzer Outlook ein zweites Mal startet, wird diese Instanz von Outlook innerhalb desselben Outlook-Prozesses ausgeführt, erstellt keinen neuen Prozess und verwendet dasselbe 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 . Eine bessere Alternative wird im folgenden Codebeispiel InitializeMAPI gezeigt: Instanziieren Sie zuerst das Outlook-Objekt Application , und verweisen Sie dann auf einen Standardordner wie den Posteingang. So wird MAPI mit dem Standardprofil gestartet und das Objektmodell ist voll funktionsfähig.

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

Wenn Sie ab Outlook 2010 über mehrere Profile verfügen, Sie Outlook so konfiguriert haben, dass immer ein Standardprofil verwendet wird. Wenn Sie sich mit der Anmeldemethode beim Standardprofil anmelden, ohne den Benutzer dazu aufzufordern, erhält der Benutzer trotzdem eine Aufforderung zur Auswahl eines Profils. Um dieses Verhalten zu vermeiden, verwenden Sie nicht die Anmeldemethode . Verwenden Sie stattdessen die im vorherigen InitializeMAPI-Beispiel vorgeschlagene Problemumgehung.

Gilt für: