IMAPIFormMgr::SelectFormContainer

  • Article

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 a form container, and returns an interface for the container object the user selected.

HRESULT SelectFormContainer(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  LPMAPIFORMCONTAINER FAR * lppfcnt
);

Parameters

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

  • ulFlags
    [in] A bitmask of flags that controls how the form library is selected (that is, how the form container is selected). The following flags can be set:

    • MAPIFORM_SELECT_ALL_REGISTRIES
      Selection can be made from all containers. This is the default selection type.

    • MAPIFORM_SELECT_FOLDER_REGISTRY_ONLY
      Selection can be made only from folder containers.

    • MAPIFORM_SELECT_NON_FOLDER_REGISTRY_ONLY
      Selection can be made only from containers that are not associated with folders.

  • lppfcnt
    [out] A pointer to a pointer to the returned interface. This interface is for the container object that is selected by the user.

Return Value

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

Remarks

Form viewers typically call the IMAPIFormMgr::SelectFormContainer method to select a form container into which a form is installed. SelectFormContainer cannot be used to select the local form container, which has the value HFRMREG_LOCAL.

MFCMAPI Reference

For MFCMAPI sample code, see the following table.

File

Function

Comment

MainDlg.cpp

CMainDlg::OnSelectFormContainer

MFCMAPI uses the IMAPIFormMgr::SelectFormContainer method to select a form container before rendering its contents.

See Also

Reference

IMAPIFormMgr : IUnknown

Concepts

MFCMAPI as a Code Sample