IMAPIFormMgr::SelectMultipleForms

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.

Presents a dialog box that enables the user to select multiple forms, and returns an array of form information objects that describe those forms.

HRESULT SelectMultipleForms(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  LPCTSTR pszTitle,
  LPMAPIFOLDER pfld,
  LPMAPIFORMINFOARRAY pfrminfoarray,
  LPMAPIFORMINFOARRAY FAR * ppfrminfoarray
);

Parameters

• ulUIParam
  [in] A handle to the parent window of the displayed dialog box.

• ulFlags
  [in] A bitmask of flags that controls the type of the passed-in strings. The following flag can be set:

  • MAPI_UNICODE
    The passed-in strings are in Unicode format. If the MAPI_UNICODE flag is not set, the strings are in ANSI format.

• pszTitle
  [in] A pointer to a string that contains the caption of the dialog box. If the pszTitle parameter is NULL, the form library provider that provides the forms supplies a default caption.

• pfld
  [in] A pointer to the folder from which to select the forms. If the pfld parameter is NULL, the forms are selected from the local, personal, or organization form container.

• pfrminfoarray
  [in] A pointer to an array of form information objects that are preselected for the user.

• ppfrminfoarray
  [out] A pointer to a pointer to the returned array of form information objects.

Return Value

• S_OK
  The call succeeded and returned the expected value or values.

• MAPI_E_BAD_CHARWIDTH
  Either the MAPI_UNICODE flag was set and the implementation does not support Unicode, or MAPI_UNICODE was not set and the implementation supports only Unicode.

• MAPI_E_USER_CANCEL
  The user canceled the operation, typically by clicking the Cancel button in the dialog box.

Remarks

Form viewers call the IMAPIFormMgr::SelectMultipleForms method to first present a dialog box that enables the user to select multiple forms and then to retrieve an array of form information objects that describe the selected forms. The SelectMultipleForms dialog box displays all forms, whether or not they are hidden (that is, whether or not their hidden properties are clear).

Notes to Implementers

If a form viewer passes the MAPI_UNICODE flag in the ulFlags parameter, all strings are Unicode. Form library providers that do not support Unicode strings should return MAPI_E_BAD_CHARWIDTH if MAPI_UNICODE is passed.

See Also

Reference

IMAPIFormMgr : IUnknown