ChangeIdleRoutine

Hace referencia a: Outlook 2013 | Outlook 2016

Cambia algunas o todas las características de una rutina de inactividad basada en FNIDLE .

Valor	Descripción
Archivo de encabezado:	Mapiutil.h
Implementado por:	MAPI
Llamado por:	Aplicaciones cliente y proveedores de servicios

VOID ChangeIdleRoutine(
  FTG ftg,
  PFNIDLE pfnIdle,
  LPVOID pvIdleParam,
  short priIdle,
  ULONG csecIdle,
  USHORT iroIdle,
  USHORT ircIdle
);

Parameters

Ftg

[in] Etiqueta de función que identifica la rutina inactiva.

pfnIdle

[in] Puntero a la rutina inactiva.

pvIdleParam

[in] Puntero a un nuevo bloque de memoria que la implementación de llamada asigna para la rutina inactiva.

priIdle

[in] Valor que representa una nueva prioridad para la rutina inactiva. Las prioridades posibles para las rutinas definidas por la implementación son mayores o menores que cero, pero no cero. Se reserva un valor de cero para un evento de usuario, como un clic del mouse o un mensaje de WM_PAINT. Los valores mayores que cero representan prioridades para las tareas en segundo plano que tienen una prioridad mayor que los eventos de usuario y que se envían como parte del bucle estándar de bomba de mensajes de Windows. Los valores inferiores a cero representan prioridades para las tareas inactivas que solo se ejecutan durante el tiempo de inactividad de la bomba de mensajes. Algunos ejemplos de prioridades son: 1 para el envío en primer plano, 1 para la inserción de caracteres de edición de energía y 3 para descargar nuevos mensajes.

csecIdle

[in] Una nueva hora, en centésimas de segundo, para aplicar a la rutina inactiva. El significado del valor de hora inicial varía en función de lo que se pasa en el parámetro iroIdle . Puede ser:

• Período mínimo de inacción del usuario que debe transcurrir antes de que el motor de inactividad MAPI llame por primera vez a la rutina de inactividad, si la marca FIROWAIT está establecida en iroIdle. Una vez transcurrido este tiempo, el motor inactivo puede llamar a la rutina de inactividad tantas veces como sea necesario.

• Intervalo mínimo entre las llamadas a la rutina de inactividad, si la marca FIROINTERVAL se establece en iroIdle.

iroIdle

[in] Máscara de bits de marcas que indican nuevas opciones para llamar a la rutina inactiva. Se debe establecer exactamente una de las siguientes marcas:

• FIROINTERVAL: el tiempo especificado por el parámetro csecIdle es el intervalo mínimo entre llamadas sucesivas a la rutina inactiva.

• FIROONCEONLY: obsoleto. No usar.

• FIROPERBLOCK: obsoleto. No usar.

• FIROWAIT: el tiempo especificado por el parámetro csecIdle es el período mínimo de inacción del usuario que debe transcurrir antes de que el motor inactivo MAPI llame a la rutina inactiva por primera vez. Una vez transcurrido este tiempo, el motor inactivo puede llamar a la rutina de inactividad tantas veces como sea necesario.

ircIdle

[in] Máscara de bits de marcas usadas para indicar los cambios que se realizarán en la rutina inactiva. Las siguientes marcas se pueden establecer en cualquier combinación:

• FIRCCSEC: un cambio en el tiempo asociado a la rutina de inactividad, es decir, un cambio indicado por el valor pasado en el parámetro csecIdle .

• FIRCIRO: un cambio en las opciones de la rutina inactiva, es decir, un cambio indicado por el valor pasado en el parámetro iroIdle .

• FIRCPFN: un cambio en el puntero rutinario inactivo, es decir, un cambio indicado por el valor pasado en el parámetro pfnIdle .

• FIRCPRI: un cambio en la prioridad de la rutina inactiva, es decir, un cambio indicado por el valor pasado en el parámetro priIdle .

• FIRCPV: un cambio en el bloque de memoria de la rutina inactiva, es decir, un cambio indicado por el valor pasado en el parámetro pvIdleParam .

Valor devuelto

Ninguno.

Comentarios

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.