IMAPIFormInfo::SaveForm

The IMAPIFormInfo::SaveForm method saves a description of a particular form in a configuration file.

Quick Info

See IMAPIFormInfo : IMAPIProp2B5FZNT.

HRESULT SaveForm(

Parameters

szFileName

[in] String naming the form descriptor message file where the form description is saved. This filename must have the .FDM extension.

Return Values

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 MAPIERROR4GS6AI structure associated with the error, call the IMAPIProp::GetLastError6IMPBE 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 with the given filename. SaveForm creates a configuration file.

Notes to Callers

Forms can be reinstalled by being selected from a list of form descriptor messages in a dialog box displayed by form library providers. The recommended extension for form descriptor messages is .FDM.

Call IMAPIProp::GetLastError6IMPBE if SaveForm returns MAPI_E_EXTENDED_ERROR and check the returned MAPIERROR structure to determine the condition causing the error.