IMAPIFormMgr::SelectFormContainer
Applies to: Office 2010 | Outlook 2010 | Visual Studio
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. |