MAPIInitIdle

Aplica-se a: Outlook 2013 | Outlook 2016

Inicializa o mecanismo ocioso MAPI para o aplicativo de chamada.

Propriedade	Valor
Arquivo de cabeçalho:	Mapiutil.h
Implementado por:	MAPI
Chamado por:	Aplicativos cliente e provedores de serviços

LONG MAPIInitIdle(
  LPVOID lpvReserved
);

Parâmetros

lpvReserved

[in] Reservados; deve ser zero.

Valor de retorno

A função MAPIInitIdle retornará zero se a inicialização for bem-sucedida e 1 caso contrário. Se MAPIInitIdle for chamado várias vezes, todas as chamadas adicionais serão bem-sucedidas, mas são ignoradas, exceto para incrementar a contagem de referências.

Comentários

Um aplicativo cliente ou provedor de serviços deve chamar MAPIInitIdle antes de chamar qualquer outra função de mecanismo ocioso.

Cada chamada para MAPIInitIdle deve ser correspondida por uma chamada subsequente ao MAPIDeInitIdle ou o mecanismo ocioso é deixado em execução para o aplicativo de chamada.

As funções a seguir lidam com o mecanismo ocioso MAPI e com rotinas ociosas com base no protótipo da função FNIDLE :

Função de rotina ociosa	Uso
ChangeIdleRoutine	Altera as características de uma rotina ociosa registrada.
DeregisterIdleRoutine	Remove uma rotina ociosa registrada do sistema MAPI.
EnableIdleRoutine	Desabilita ou habilita novamente uma rotina ociosa registrada sem removê-la do sistema MAPI.
FtgRegisterIdleRoutine	Adiciona uma rotina ociosa ao sistema MAPI, com ou sem habilitá-la.
MAPIDeInitIdle	Desliga o mecanismo ocioso MAPI para o aplicativo de chamada.
MAPIInitIdle	Inicializa o mecanismo ocioso MAPI para o aplicativo de chamada.

Quando todas as tarefas em primeiro plano para a plataforma ficam ociosas, o mecanismo ocioso MAPI chama a rotina ociosa de maior prioridade que está pronta para ser executada. Não há garantia de chamada de ordem entre rotinas ociosas da mesma prioridade.