[in] A handle to the parent window of any dialog boxes or windows that this method displays. The ulUIParam parameter is ignored unless the client application sets the MAPI_DIALOG flag in the ulFlags parameter. The ulUIParam parameter can be NULL if MAPI_DIALOG is not also passed.
[in] A bitmask of flags that controls the installation of the form. The following flags can be set:
Displays a dialog box to provide progress information or prompt the user for more information. If this flag is not set, no dialog box is displayed.
The passed-in strings are in Unicode format. If the MAPI_UNICODE flag is not set, the strings are in ANSI format.
If another form already exists that handles the message class handled by this form, replace the existing form with this one. This flag is ignored if the MAPI_DIALOG flag is also present.
Client applications call the IMAPIFormContainer::InstallForm method to install a form into a specific form container. The szCfgPathName parameter must contain the path of a form configuration file (that is, a file with the .cfg extension that describes the form and its implementation). The flags in the ulFlags parameter specify the following:
If the MAPI_DIALOG flag is set, a user interface is displayed, enabling the user who is installing the form to specify installation details.
If the MAPIFORM_INSTALL_OVERWRITEONCONFLICT flag is set, any previous form for the same message class is replaced with the form being installed. Otherwise, the form installation is merged with the current form description, if one exists.
If MAPI_DIALOG is set, MAPIFORM_INSTALL_OVERWRITEONCONFLICT is ignored.
The absence of MAPIFORM_INSTALL_OVERWRITEONCONFLICT in the flag set means that a merge will be done. Any new platforms in the .cfg file that are not currently present in the form description will be installed and no other changes will occur.
If the MAPI_UNICODE flag is set, the path of the form configuration file is a Unicode string.