Platform SDK: SMTP Server Events

ISMTPStoreDriver Interface

[This is preliminary documentation and subject to change.]

The ISMTPStoreDriver interface defines methods used by the SMTP service to initialize and manage the store driver object as well as deliver messages identified for local delivery.

IID: ee51588c-d64a-11d1-9ff7-00c04fa37348
Extends: IUnknown

Methods

Method	Description
Init	Initialize the store driver.
PrepareForShutdown	Notify the store driver that shutdown is commencing.
Shutdown	Shutdown the store driver.
LocalDelivery	Deliver a message using the store driver.
EnumerateAndSubmitMessages	Enumerate all the messages currently associated with the store driver.

Remarks

The ISMTPStoreDriver interface is mandatory for store driver sinks and is a companion to the IMailMsgStoreDriver interface. The ISMTPStoreDriver interface is used by the SMTP service to:

Initialize each instance of a store driver COM class with an SMTP virtual service identifier and a reference to an object exposing the ISMTPServer interface. The store driver uses this interface to submit messages to the SMTP service, etc.
Deliver messages to recipients that have local mailboxes.
Request the store driver to enumerate undelivered messages and submit each to the service.
Shutdown (cleanly) the store driver in a two-phase shutdown sequence consisting of PrepareForShutdown and Shutdown.

The SMTP service allocates backing storage for incoming messages using the IMailMsgStoreDriver interface on the store driver object.