FNIDLE

Aplica-se a: Outlook 2013 | Outlook 2016

Define uma rotina ociosa que o mecanismo ocioso MAPI chama periodicamente de acordo com a prioridade.

Propriedade	Valor
Arquivo de cabeçalho:	Mapiutil.h
Função definida implementada por:	Aplicativos cliente e provedores de serviços
Função definida chamada por:	MAPI
Tipo de ponteiro correspondente:	PFNIDLE

BOOL (STDAPICALLTYPE FNIDLE)(
  LPVOID lpvContext
);

Parâmetros

lpvContext

[in] Ponteiro para um bloco de memória que MAPI passa para a rotina ociosa sempre que ele chama. Esse ponteiro é passado para o mecanismo ocioso MAPI no parâmetro pvIdleParam por FtgRegisterIdleRoutine. Os dados no bloco de memória podem fornecer contexto para a chamada para a rotina ociosa, como em qual objeto operar ou o estado atual de uma operação longa.

Valor de retorno

FALSE

Uma rotina ociosa com o protótipo FNIDLE deve sempre retornar FALSE.

Comentários

A funcionalidade específica da rotina ociosa é determinada pela implementação do aplicativo cliente ou do provedor de serviços.

O cliente ou provedor deve limitar o tempo de execução de cada estado de uma rotina ociosa. Cada estado deve executar uma quantidade mínima de processamento, atualizar o estado atual nos dados de contexto apontados por lpvContext e retornar ao mecanismo ocioso MAPI.

O cliente ou provedor deve chamar a função MAPIInitIdle para poder registrar sua própria rotina ociosa com uma chamada para a função FtgRegisterIdleRoutine .

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.

ChangeIdleRoutine, DeregisterIdleRoutine e EnableIdleRoutine tomam como parâmetro de entrada a marca de função retornada por FtgRegisterIdleRoutine.

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.