IMAPISupport::SpoolerYield
Applies to: Office 2010 | Outlook 2010 | Visual Studio
Gives control of the CPU to the MAPI spooler so that it can perform any tasks it considers necessary.
HRESULT SpoolerYield(
ULONG ulFlags
);
Parameters
- ulFlags
Reserved; must be zero.
Return Value
S_OK
The transport provider successfully released the CPU.MAPI_W_CANCEL_MESSAGE
Instructs the transport provider to stop the delivery of the message to any recipients that have not yet received it.
Remarks
The IMAPISupport::SpoolerYield method is implemented for transport provider support objects. Transport providers call SpoolerYield to allow the MAPI spooler to accomplish any necessary processing.
Notes to Callers
Call SpoolerYield when you are performing lengthy operations that can be paused. This allows foreground applications to run during a long operation, such as delivery to a large recipient list across a busy network.
If SpoolerYield returns with MAPI_W_CANCEL_MESSAGE, the MAPI spooler has determined that the message should no longer be sent. Return MAPI_E_USER_CANCEL to your calling process and exit, if possible.
For more information about yielding to the MAPI spooler, see Interacting with the MAPI Spooler.