The MAPIDeInitIdle function shuts down the MAPI idle engine for the calling application.
Note This function may not be supported in future versions of MAPI.
| Header file: | MAPIUTIL.H |
| Implemented by: | MAPI |
| Called by: | Client applications and service providers |
VOID MAPIDeInitIdle(void)None.
A client application or service provider should call MAPIDeInitIdle when it no longer needs the idle engine, for example, when it is about to stop processing.
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.