Compartir a través de


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.
  • 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.

See Also

Reference

IMAPIFormMgr::CreateForm

IMAPIFormMgr::LoadForm

IMAPIFormMgr : IUnknown