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

Definição

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Faz logon do usuário na MAPI, obtendo uma sessão 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

O nome do perfil MAPI, como uma cadeia de caracteres (cadeia de caracteres em C#), a ser usada para a sessão. Especifique uma sequência vazia para usar o perfil padrão para a sessão atual.

Password

Object

A senha (se houver), como uma cadeia de caracteres (cadeia de caracteres em C#), associada ao perfil. Esse parâmetro existe apenas para compatibilidade com versões anteriores e por motivos de segurança, ele não é recomendado para uso. O Microsoft Outlook solicitará que o usuário especifique uma senha na maioria das configurações do sistema. Esta é a senha de logon e não deve ser confundida com senhas de PST.

ShowDialog

Object

True para exibir a caixa de diálogo de logon MAPI para permitir que o usuário selecione um perfil MAPI.

NewSession

Object

True para criar uma nova sessão do Outlook. Desde que não não possível criar várias sessões no Outlook, esse parâmetro deve ser especificado como True somente se uma sessão ainda não existir.

Comentários

Use o método Logon somente para fazer logon um perfil específico quando o Outlook não está em execução. Isso ocorre porque apenas um processo do Outlook pode ser executado por vez, e esse processo Outlook usa apenas um perfil e suporta apenas uma sessão MAPI. Quando um usuário inicia o Outlook uma segunda vez, essa instância do Outlook é executada no mesmo processo do Outlook, não cria um novo processo e usa o mesmo perfil.

Se o Outlook estiver sendo executado, o uso desse método não criar uma nova sessão do Outlook ou alterar o perfil atual para um diferente.

Se o Outlook não está sendo executado e você deseja iniciar o Outlook com o perfil padrão, não use o método Logon. Uma alternativa melhor é mostrada no exemplo de código a seguir InitializeMAPI: primeiro, instancie o objeto Outlook Application e referencie uma pasta padrão, como a caixa de entrada. Isso tem o efeito do lado do Inicializando MAPI para usar o perfil padrão e para tornar o modelo de objeto 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 do Outlook 2010, se você tiver vários perfis, configurou o Outlook para sempre usar um perfil padrão e usar o método Logon para fazer logon no perfil padrão sem solicitar ao usuário, o usuário receberá um prompt para escolher um perfil de qualquer maneira. Para evitar esse comportamento, não use o método Logon ; use a solução alternativa sugerida no exemplo initializeMAPI anterior.