Platform SDK: MAPI |
The IPersistMessage interface is used by form viewers to handle the storage of a form and to transition between the various states.
Header file: | MAPIFORM.H |
Exposed by: | Persist message objects |
Implemented by: | Form objects |
Called by: | Form viewers |
Interface identifier: | IID_IPersistMessage |
Pointer type: | LPPERSISTMESSAGE |
GetLastError | Returns a MAPIERROR structure containing information about the previous error in the form object. |
GetClassID | Returns an identifier representing the form server that can manage the form. |
IsDirty | Checks the form for changes made since the last save. |
InitNew | Initializes a new message. |
Load | Loads the form for a specified message. |
Save | Saves a revised form back to the message from which it was loaded or created. |
SaveCompleted | Notifies the form that a save operation has been completed. |
HandsOffMessage | Causes the form to release its current message. |
All forms are required to implement the IPersistMessage interface.
IPersistMessage works similarly to the OLE IPersistStorage interface; for more information on the IPersistStorage methods, and on working with storage objects in general, see the OLE Programmer's Reference.