Verificar a configuração do provedor de serviços
Aplica-se a: Outlook 2013 | Outlook 2016
Seu método de logon (IABProvider::Logon, IMSProvider::Logon ou IXPProvider::TransportLogon) deve verificar a configuração do provedor. Isso envolve verificar se todas as propriedades necessárias para a operação completa são definidas corretamente. Cada provedor requer um número diferente de propriedades; a configuração depende do provedor e do grau de interação do usuário que você permite. Alguns provedores de serviços mantêm todas as propriedades necessárias no perfil.
Outros provedores de serviços mantêm um conjunto parcial de propriedades no perfil e solicitam ao usuário valores ausentes. Outros provedores ainda não armazenam propriedades no perfil, contando com o usuário para fornecer todas as informações necessárias para a configuração.
Para recuperar propriedades armazenadas no perfil
Chame IMAPISupport::OpenProfileSection, passando o MAPIUID do seu provedor como um parâmetro de entrada.
Chame os métodos IMAPIProp::GetProps ou IMAPIProp::GetPropList da seção de perfil para recuperar propriedades individuais ou uma lista de propriedades.
Para definir propriedades a partir de informações do usuário
Exiba uma folha de propriedades, se MAPI não tiver definido um sinalizador proibindo a exibição. Os sinalizadores a seguir indicam que uma interface do usuário não pode ser apresentada.
| Flag | Provedor de serviços |
|---|---|
| AB_NO_DIALOG |
Provedor de catálogo de endereços |
| LOGON_NO_DIALOG |
Provedor de transporte |
| MDB_NO_DIALOG |
Provedor do repositório de mensagens |
Se o provedor não armazenar todas as suas propriedades de configuração no perfil, exigindo interação do usuário e o MAPI passar um dos sinalizadores de supressão da caixa de diálogo para o método de logon, retorne MAPI_E_UNCONFIGURED. Também retorne esse erro quando o sinalizador de supressão de caixa de diálogo não estiver definido, mas o usuário não fornece todas as informações necessárias.
Quando o provedor de serviços falha no método de logon com MAPI_E_UNCONFIGURED, o MAPI chama sua função de ponto de entrada novamente. Se as informações não puderem ser localizadas com a segunda chamada, a sessão poderá ser encerrada, dependendo da importância do provedor de serviços.
A ilustração a seguir mostra a lógica necessária para a configuração no método de logon do provedor de serviços.
Configuration verification flowchart
de