Platform SDK: MAPI

MAPIInitIdle

The MAPIInitIdle function initializes the MAPI idle engine for the calling application.

Note  This function may not be supported in future versions of MAPI.

Quick Info

Header file: MAPIUTIL.H
Implemented by: MAPI
Called by: Client applications and service providers

LONG MAPIInitIdle(
  LPVOID lpvReserved  
);
 

Parameter

lpvReserved
Reserved; must be zero.

Remarks

A client application or service provider must call MAPIInitIdle before calling any other idle engine function.

The MAPIInitIdle function returns zero if initialization is successful, and –1 otherwise. If MAPIInitIdle is called multiple times, all additional calls succeed but are ignored except to increment the reference count.

Every call to MAPIInitIdle must be matched by a subsequent call to MAPIDeInitIdle, or the idle engine is left running for the calling application.

The following functions deal with the MAPI idle engine and with idle routines based on the FNIDLE function prototype:

Idle routine function Usage
ChangeIdleRoutine Changes the characteristics of a registered idle routine.
DeregisterIdleRoutine Removes a registered idle routine from the MAPI system.
EnableIdleRoutine Disables or re-enables a registered idle routine without removing it from the MAPI system.
FtgRegisterIdleRoutine Adds an idle routine to the MAPI system, with or without enabling it.
MAPIDeInitIdle Shuts down the MAPI idle engine for the calling application.
MAPIInitIdle Initializes the MAPI idle engine for the calling application.

When all foreground tasks for the platform become idle, the MAPI idle engine calls the highest priority idle routine that is ready to execute. There is no guarantee of calling order among idle routines of the same priority.

See Also

Idle Routine Functions