Compartir a través de


DeregisterIdleRoutine

Hace referencia a: Outlook 2013 | Outlook 2016

Quita una rutina de inactividad basada en FNIDLE del sistema MAPI.

Propiedad Valor
Archivo de encabezado:
Mapiutil.h
Implementado por:
MAPI
Llamado por:
Aplicaciones cliente y proveedores de servicios
VOID DeregisterIdleRoutine(
  FTG ftg
);

Parameters

Ftg

[in] Etiqueta de función que identifica la rutina de inactividad que se va a quitar.

Valor devuelto

Ninguno.

Comentarios

Cualquier tarea de una aplicación cliente o proveedor de servicios puede anular el registro de cualquier rutina de inactividad para la que tenga un parámetro ftg válido. En concreto, una rutina inactiva puede anular el registro.

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.

Después de anular el registro de la rutina de inactividad, el motor inactivo no la vuelve a llamar. Cualquier implementación que llame a DeregisterIdleRoutine debe desasignar los bloques de memoria a los que pasó punteros para que el motor inactivo se use en su llamada original a la función FtgRegisterIdleRoutine .