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

Definición

Espacio de nombres:

Microsoft.Office.Interop.Outlook

Ensamblado:

Microsoft.Office.Interop.Outlook.dll

Inicia una sesión de usuario en MAPI, por lo que obtiene una sesión 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)

Parámetros

Profile

Object

El nombre del perfil MAPI, como una cadena (cadena en C#), que se va a usar para la sesión. Especifique una cadena vacía para usar el perfil predeterminado para la sesión actual.

Password

Object

La contraseña (si existe), como una cadena (cadena en C#), asociada al perfil. Este parámetro existe sólo para compatibilidad con versiones anteriores y por motivos de seguridad, no se recomienda para su uso. Microsoft Outlook pedirá al usuario que especifique una contraseña en la mayoría de las configuraciones del sistema. Esta es la contraseña de inicio de sesión y no se debe confundir con las contraseñas PST.

ShowDialog

Object

True para mostrar el cuadro de diálogo de inicio de sesión MAPI para permitir que el usuario seleccione un perfil MAPI.

NewSession

Object

Es True para crear una nueva sesión de Outlook. Dado que no se pueden crear varias sesiones en Outlook, este parámetro debe especificarse como True sólo si no existe ya una sesión.

Comentarios

Utilice el método Logon solo para iniciar sesión en un perfil específico cuando Outlook no se está ejecutando. Esto es debido a que sólo un proceso de Outlook puede ejecutar a la vez, y ese proceso de Outlook usa un solo perfil y admite sólo una sesión MAPI. Cuando un usuario inicia Outlook por segunda vez, esa instancia de Outlook se ejecuta dentro del mismo proceso de Outlook, no crea un nuevo proceso y usa el mismo perfil.

Si ya se está ejecutando Outlook, usar este método crea una nueva sesión de Outlook no o cambiar el perfil actual a otro.

Si no se está ejecutando Outlook y sólo desea que se inicie Outlook con el perfil predeterminado, no use el método Logon. Se muestra una alternativa mejor en el siguiente ejemplo de código InitializeMAPI: en primer lugar, cree una instancia del objeto de Outlook Application y, a continuación, haga referencia a una carpeta predeterminada, como la Bandeja de entrada. Esto tiene el efecto de lado de inicialización de MAPI para usar el perfil predeterminado y hacer que el modelo de objetos totalmente funcional.

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

A partir de Outlook 2010, si tiene varios perfiles, ha configurado Outlook para que siempre use un perfil predeterminado y use el método Logon para iniciar sesión en el perfil predeterminado sin preguntar al usuario, el usuario recibirá un mensaje para elegir un perfil de todos modos. Para evitar este comportamiento, no use el método Logon ; use la solución alternativa sugerida en el ejemplo de InitializeMAPI anterior en su lugar.