CreateMAPIInitializationMonitor
Aplica-se a: Outlook 2016 | Outlook 2019
Monitor de Inicialização MAPI
Há momentos em que um aplicativo que consome MAPI pode querer saber quando a inicialização é concluída. Por exemplo, ele tem vários threads que poderiam inicializar MAPI ou em resposta à inicialização do MAPI que o aplicativo gostaria de executar algum trabalho, mas não deseja sempre girar a pilha MAPI. O monitor de inicialização fornece essa funcionalidade por meio de uma função (exportada de OLMAPI32.DLL) e algumas interfaces simples descritas abaixo.
HRESULT CreateMAPIInitializationMonitor(IMAPIInitMonitor** ppInitMonitor);
HRESULT STDAPICALLTYPE CreateMapiInitializationMonitor(IMAPIInitMonitor ppInitMonitor)
Esse ponto de entrada exportado de OLMAPI32.DLL permite que o chamador recupere uma interface para consultar o estado de inicialização atual, configure um retorno de chamada para conclusão de inicialização ou bloqueie o thread atual até que seja concluído. O objeto retornado dessa API é reutilizável e com thread seguro e pode ser invocado de qualquer thread, não apenas thread que o recuperou. Além disso, ao contrário de outros objetos expostos do MAPI, esse objeto é válido desde que a DLL seja carregada, ele pode ser reutilizado em sessões de inicialização e pode ser consumido antes ou depois que MAPIInitialize for chamado. Retorna sucesso ou falha por meio de um HRESULT padrão com e atribui um parâmetro out a uma instância do IMAPIInitMonitor.
Parâmetros
ppInitMonitor
[out] Um ponteiro para receber a instância recém-criada do monitor de inicialização MAPI.
Valores de retorno
S_OK
Uma nova instância do monitor de inicialização foi criada com êxito.
E_OUTOFMEMORY
Não havia memória suficiente para engradar um novo objeto.