Implementando o logon do provedor de serviços

Aplica-se a: Outlook 2013 | Outlook 2016

O MAPI chama um método em seu objeto de provedor para iniciar o processo de logon usando o ponteiro que você retorna da função de ponto de entrada. O método varia da seguinte maneira, dependendo do tipo do seu provedor de serviços:

Execute as seguintes tarefas em qualquer método de logon implementado:

  1. Aumente a contagem de referência no objeto de suporte que é passado como um parâmetro de entrada chamando seu método IUnknown::AddRef .

  2. Chame o método IMAPISupport::OpenProfileSection do objeto de suporte para acessar sua seção de perfil.

  3. Chame o método IMAPIProp::SetProps da seção de perfil para definir as seguintes propriedades:

Observação

Não tente definir as propriedades de PR_RESOURCE_FLAGS ou PR_PROVIDER_DLL_NAME da seção do perfil. No momento do logon, essas propriedades são somente leitura.

  1. Verifique se as propriedades necessárias para a configuração estão armazenadas no perfil ou estão disponíveis para o usuário. Para obter mais informações sobre como verificar sua configuração, consulte Verificando a configuração do provedor de serviços.

  2. Chame o método IMAPISupport::SetProviderUID do objeto de suporte para registrar um identificador exclusivo, ou MAPIUID, se o provedor for um catálogo de endereços ou um provedor de repositório de mensagens. Os provedores de transporte registram estruturas MAPIUID quando o MAPI chama seu método IXPLogon::AddressTypes . Para obter mais informações sobre como registrar um MAPIUID, consulte Registrando identificadores exclusivos do provedor de serviços.

  3. Instancie um objeto de logon e retorne com um dos seguintes valores:

  • S_OK para indicar um logon bem-sucedido.

  • MAPI_E_UNCONFIGURED para indicar que uma ou mais das propriedades de configuração não estavam disponíveis.

  • MAPI_E_USER_CANCEL para indicar que o usuário cancelou a caixa de diálogo de configuração, fazendo com que as propriedades de configuração ficassem indisponíveis.

  • MAPI_E_FAILONEPROVIDER indicar que o provedor não pôde ser configurado, mas que o MAPI deve permitir que ele seja usado independentemente. Os métodos de logon devem retornar esse valor para relatar um erro não fatal, como quando o provedor exige uma senha e não pode solicitar ao usuário porque a interface do usuário está desabilitada.

A lista anterior de tarefas descreve uma implementação mínima para um método de logon do provedor de serviços. Você pode incluir funcionalidades adicionais, se necessário. Por exemplo, alguns provedores chamam IMAPISupport::ModifyStatusRow para atualizar a tabela de status em seu método de logon.

Observação

Para obter o melhor desempenho no momento do logon, evite chamar IMAPISupport::P repareSubmit ou IMAPISupport::SpoolerNotify. Antes que essas chamadas possam ser concluídas e retornar o controle ao método de logon, o spooler MAPI deve ser iniciado.

Confira também

  • Last updated on