Compartilhar via


DeregisterIdleRoutine

Aplica-se a: Outlook 2013 | Outlook 2016

Remove uma rotina ociosa baseada em FNIDLE do sistema MAPI.

Propriedade Valor
Arquivo de cabeçalho:
Mapiutil.h
Implementado por:
MAPI
Chamado por:
Aplicativos cliente e provedores de serviços
VOID DeregisterIdleRoutine(
  FTG ftg
);

Parâmetros

Ftg

[in] Marca de função que identifica a rotina ociosa a ser removida.

Valor de retorno

Nenhum.

Comentários

Qualquer tarefa em um aplicativo cliente ou provedor de serviços pode desregistrar qualquer rotina ociosa para a qual tenha um parâmetro ftg válido. Em particular, uma rotina ociosa pode se desregistrar.

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.

Depois que a rotina ociosa é desregistrado, o mecanismo ocioso não o chama novamente. Qualquer implementação que chame DeregisterIdleRoutine deve desalocar todos os blocos de memória aos quais passou ponteiros para que o mecanismo ocioso seja usado em sua chamada original para a função FtgRegisterIdleRoutine .