IMAPIFormInfo::SaveForm
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Saves a description of a particular form in a configuration file.
HRESULT SaveForm(
LPCTSTR szFileName
);
Parameters
- szFileName
[in] A string that names the form's description message file where its description is saved. This file name must have the .fdm extension.
Return Value
S_OK
The call succeeded and has returned the expected value or values.MAPI_E_EXTENDED_ERROR
The configuration file could not be written. To get the MAPIERROR structure that is associated with the error, call the IMAPIProp::GetLastError method.MAPI_E_NO_SUPPORT
SaveForm was probably called to save a form in the local form container. SaveForm is not supported on the local form container.
Remarks
Client applications call the IMAPIFormInfo::SaveForm method to save a description of the current form in the file that has the given file name. SaveForm creates a configuration file.
Notes to Callers
You can reinstall forms by selecting them from a list of form descriptor messages in a dialog box that form library providers display. The recommended extension for form descriptor messages is .fdm.
Call the IMAPIProp::GetLastError method if SaveForm returns MAPI_E_EXTENDED_ERROR, and check the returned MAPIERROR structure to determine the condition that caused the error.