Compartilhar via


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.

Confira também

IMAPIInitMonitor

IMAPIWaitResult