IPSTX::EmulateSpooler

Applies to: Outlook 2013 | Outlook 2016

Sets a local store to emulate the Outlook Protocol Manager to spool outgoing messages to a server.

HRESULT EmulateSpooler( 
    BOOL fEmulate 
);

fEmulate

[in] Set this parameter to True if the local store should emulate the spooler; set it to False if not.

Remarks

A local store calls IPSTX::EmulateSpooler to act as an Outlook Protocol Manager, spooling messages in the outgoing queue to the back-end server (for example, MSN server or AOL server) for processing. Emulating a spooler during synchronization, the store then calls these two methods:

  1. IMsgStore::GetOutgoingQueue to get the outgoing queue of messages in the store. This method succeeds only if the store is emulating the Outlook Protocol Manager.

  2. IMsgStore::SetLockState to secure sole access to a message in the outgoing queue just before sending it to the server. This method succeeds only if the store is emulating the Outlook Protocol Manager. After sending the message, the store calls this method again to release sole access to it.

Note

Since Outlook 2002, the Outlook Protocol Manager replaced the MAPI spooler and became responsible for spooling outgoing messages to back-end servers.

See also

IPSTX::GetLastError

IPSTX::GetSyncObject