IMAPIFormMgr::PrepareForm
Applies to: Office 2010 | Outlook 2010 | Visual Studio
Downloads a form for opening.
HRESULT PrepareForm(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPMAPIFORMINFO pfrmiInfo
);
Parameters
ulUIParam
[in] A handle to the parent window of the progress indicator that is displayed while the form is downloaded. The ulUIParam parameter is ignored unless the MAPI_DIALOG flag is set in the ulFlags parameter.ulFlags
[in] A bitmask of flags that controls how the form is downloaded. The following flag can be set:- MAPI_DIALOG
Displays a user interface to provide status or prompt the user for more information. If this flag is not set, no user interface is displayed.
- MAPI_DIALOG
pfrmiInfo
[in] A pointer to a form information object for the form to be downloaded.
Return Value
- S_OK
The call succeeded and has returned the expected value or values.
Remarks
Form viewers call the IMAPIFormMgr::PrepareForm method to download a form from a form container for opening. Most form viewers do not need to call PrepareForm, because both the IMAPIFormMgr::CreateForm and IMAPIFormMgr::LoadForm methods call PrepareForm, if necessary.
You can use PrepareForm to obtain the dynamic-link libraries (DLLs) and other files associated with a form to modify them. If the modified form is loaded back into its form container, it must be reinstalled.