Last modified: July 23, 2011
Applies to: Outlook
Returns a MAPIERROR structure that contains information about the previous error in the form object.
Form objects implement the IPersistMessage::GetLastError method to supply information about a prior method call that failed. Form viewers can provide their users with detailed information about the error by including the data from the MAPIERROR structure in a dialog box.
A call to GetLastError does not affect the state of the form. When GetLastError returns, the form remains in the state that it was in before the call was made.
You can use the MAPIERROR structure, if the form supplies one, that is pointed to by the lppMAPIError parameter only if GetLastError returns S_OK. Sometimes the form cannot determine what the last error was or has nothing more to report about the error. In this situation, the form returns a pointer to NULL in lppMAPIError instead.
For more information about the GetLastError method, see MAPI Extended Errors.