IMAPIFormMgr::OpenFormContainer
Hace referencia a: Outlook 2013 | Outlook 2016
Abre una interfaz IMAPIFormContainer para un contenedor de formulario específico.
HRESULT OpenFormContainer(
HFRMREG hfrmreg,
LPUNKNOWN lpunk,
LPMAPIFORMCONTAINER FAR * lppfcnt
);
Parameters
hfrmreg
[in] Enumeración HFRMREG que indica la biblioteca de formularios que se va a abrir (es decir, el contenedor de formularios que se va a abrir). Una enumeración HFRMREG es una enumeración específica de un proveedor de biblioteca de formularios. Entre los valores de HFRMREG posibles se incluyen los siguientes:
HFRMREG_DEFAULT
Un práctico contenedor de formularios.
HFRMREG_FOLDER
Contenedor de carpetas.
HFRMREG_PERSONAL
Contenedor del almacén de mensajes predeterminado.
HFRMREG_LOCAL
Un contenedor de formularios local.
lpunk
[in] Puntero al objeto para el que se abre la interfaz. El parámetro lpunk debe ser null a menos que el valor del parámetro hfrmreg requiera un puntero de objeto.
lppfcnt
[out] Puntero a un puntero al objeto contenedor de formulario devuelto.
Valor devuelto
S_OK
La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.
MAPI_E_NO_INTERFACE
El objeto al que apunta lpunk no admite la interfaz necesaria.
Comentarios
Los visores de formularios llaman al método IMAPIFormMgr::OpenFormContainer para abrir una interfaz IMAPIFormContainer para un contenedor de formularios específico. Esta interfaz se puede usar para instalar formularios y quitar formularios de un contenedor de formularios.
Notas para los llamadores
Si el valor de hfrmreg es HFRMREG_FOLDER, el identificador de interfaz usado en lpunk debe ser distinto de null y debe permitir llamadas al método IUnknown::QueryInterface a una interfaz IMAPIFolder .
Para abrir el contenedor de formularios local, debe usar una llamada al método OpenFormContainer o a la función MAPIOpenLocalFormContainer ; no puede usar el método IMAPIFormMgr::SelectFormContainer para permitir que el usuario seleccione el contenedor de formularios local.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MainDlg.cpp |
CMainDlg::OnOpenFormContainer |
MFCMAPI usa el método IMAPIFormMgr::OpenFormContainer para recuperar un contenedor de formularios de modo que se pueda representar el contenido del contenedor. |
| MsgStoreDlg.cpp |
CMsgStoreDlg::OnOpenFormContainer |
MFCMAPI usa el método IMAPIFormMgr::OpenFormContainer para recuperar un contenedor de formularios de una carpeta de modo que se pueda representar el contenido del contenedor. |
Vea también
IMAPIFormContainer::InstallForm