MAPI implements the IMAPIStatus interface to provide status information about the MAPI subsystem, the integrated address book and the MAPI spooler. A service provider implements IMAPIStatus to supply information about its own status.
Displays a property sheet enabling the user to change a service provider's configuration. This method is not supported in status objects implemented by MAPI.
Modifies a service provider's password without displaying a user interface. This method is optionally supported in status objects implemented by service providers.
Forces all messages waiting to be sent or received to be immediately uploaded or downloaded. This method is supported by the MAPI spooler status object and status objects implemented by transport providers.
The status objects implemented by MAPI support the following methods:
Status object
Supported methods
MAPI subsystem
ValidateState only
MAPI address book
ValidateState only
MAPI spooler
ValidateState and FlushQueues
The status objects implemented by MAPI are required to have a read-only version of the methods of the IMAPIProp interface and support the IMAPIStatus::ValidateState method. Transport providers are strongly recommended to also support FlushQueues. All providers are encouraged to support SettingsDialog and support for ChangePassword is optional.
Clients use status objects to perform configuration and to learn about the state of the session. They access a status object by calling the OpenStatusEntry method of a service provider logon object or IMAPISession::GetStatusTable to retrieve the status object.