FNIDLE

Hace referencia a: Outlook 2013 | Outlook 2016

Define una rutina de inactividad a la que el motor de inactividad MAPI llama periódicamente según la prioridad.

Propiedad	Valor
Archivo de encabezado:	Mapiutil.h
Función definida implementada por:	Aplicaciones cliente y proveedores de servicios
Función definida a la que llama:	MAPI
Tipo de puntero correspondiente:	PFNIDLE

BOOL (STDAPICALLTYPE FNIDLE)(
  LPVOID lpvContext
);

Parameters

lpvContext

[in] Puntero a un bloque de memoria que MAPI pasa a la rutina inactiva cada vez que lo llama. FtgRegisterIdleRoutine pasa este puntero al motor de inactividad MAPI en el parámetro pvIdleParam. Los datos del bloque de memoria pueden proporcionar contexto para la llamada a la rutina de inactividad, como el objeto en el que trabajar o el estado actual de una operación larga.

Valor devuelto

FALSE

Una rutina de inactividad con el prototipo de FNIDLE siempre debe devolver FALSE.

Comentarios

La funcionalidad específica de la rutina de inactividad viene determinada por la aplicación cliente o el proveedor de servicios de implementación.

El cliente o proveedor debe limitar el tiempo de ejecución de cada estado de una rutina inactiva. Cada estado debe realizar una cantidad mínima de procesamiento, actualizar el estado actual en los datos de contexto a los que apunta lpvContext y volver al motor de inactividad MAPI.

El cliente o proveedor debe llamar a la función MAPI MAPIInitIdle para poder registrar su propia rutina de inactividad con una llamada a la función FtgRegisterIdleRoutine .

Las siguientes funciones tratan con el motor de inactividad MAPI y con rutinas de inactividad basadas en el prototipo de función FNIDLE:

Función rutinaria inactiva	Uso
ChangeIdleRoutine	Cambia las características de una rutina de inactividad registrada.
DeregisterIdleRoutine	Quita una rutina de inactividad registrada del sistema MAPI.
EnableIdleRoutine	Deshabilita o vuelve a habilitar una rutina de inactividad registrada sin quitarla del sistema MAPI.
FtgRegisterIdleRoutine	Agrega una rutina inactiva al sistema MAPI, con o sin habilitarla.
MAPIDeInitIdle	Apaga el motor de inactividad MAPI para la aplicación que realiza la llamada.
MAPIInitIdle	Inicializa el motor de inactividad MAPI para la aplicación que realiza la llamada.

ChangeIdleRoutine, DeregisterIdleRoutine y EnableIdleRoutine toman como parámetro de entrada la etiqueta de función devuelta por FtgRegisterIdleRoutine.

Cuando todas las tareas en primer plano de la plataforma se inactivan, el motor de inactividad MAPI llama a la rutina de inactividad de prioridad más alta que está lista para ejecutarse. No hay ninguna garantía de orden de llamada entre rutinas inactivas de la misma prioridad.