Compartir a través de


MAPIInitIdle

Hace referencia a: Outlook 2013 | Outlook 2016

Inicializa el motor de inactividad MAPI para la aplicación que realiza la llamada.

Propiedad Valor
Archivo de encabezado:
Mapiutil.h
Implementado por:
MAPI
Llamado por:
Aplicaciones cliente y proveedores de servicios
LONG MAPIInitIdle(
  LPVOID lpvReserved
);

Parameters

lpvReserved

[entrada] Reservado; debe ser cero.

Valor devuelto

La función MAPIInitIdle devuelve cero si la inicialización se realiza correctamente y 1 en caso contrario. Si mapiInitIdle se llama varias veces, todas las llamadas adicionales se realizan correctamente, pero se omiten excepto para incrementar el recuento de referencias.

Comentarios

Una aplicación cliente o un proveedor de servicios debe llamar a MAPIInitIdle antes de llamar a cualquier otra función del motor inactiva.

Cada llamada a MAPIInitIdle debe coincidir con una llamada posterior a MAPIDeInitIdle o el motor inactivo se queda en ejecución para la aplicación que realiza la llamada.

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.

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.