IMAPIFormMgr::SelectFormContainer

The IMAPIFormMgr::SelectFormContainer method presents a dialog box that enables the user to select a form container and returns an interface for the container object the user selected.

Quick Info

See IMAPIFormMgr : IUnknown.

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

Parameters

ulUIParam

[in] Handle of the parent window for the dialog box displayed.

ulFlags

[in] 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 type of selection is the default.

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 not associated with folders.

lppfcnt

[out] Pointer to a pointer to the returned interface. This interface is for the container object selected by the user.

Return Values

S_OK

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

Remarks

Form viewers commonly 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.