FNIDLE
The FNIDLE
function prototype defines an idle function that the MAPI idle engine calls
periodically according to priority. The specific functionality of the idle function
is defined by the client or provider.
Note This function
may not be supported in future versions of MAPI.
Quick Info
|
Header
file: |
MAPIUTIL.H |
|
Defined
function implemented by: |
Client
applications and service providers |
|
Defined
function called by: |
MAPI |
BOOL (STDAPICALLTYPE FNIDLE)(
|
LPVOID lpvContext |
|
|
); |
|
Parameters
lpvContext
[in]
Specifies a pointer to a block of memory. The idle function can use this value
as a pointer to a state buffer for length operations.
Return Values
FALSE
An idle
function with the FNIDLE prototype should always return FALSE.
Remarks
A client application
or service provider must call the idle engine function Idle_InitDLL
before it can register its own idle function with a call to the FtgRegisterIdleRoutine
function.
Then the client application or provider can use these other idle engine
functions as needed during idle operations:
EnableIdleRoutine
ChangeIdleRoutine
DeregisterIdleRoutine
Idle_DeInitDLL
FIsIdleExit
FDoNextIdleTask