IMAPIFormMgr::OpenFormContainer
S’applique à : Outlook 2013 | Outlook 2016
Ouvre une interface IMAPIFormContainer pour un conteneur de formulaires spécifique.
HRESULT OpenFormContainer(
HFRMREG hfrmreg,
LPUNKNOWN lpunk,
LPMAPIFORMCONTAINER FAR * lppfcnt
);
hfrmreg
[in] Énumération HFRMREG qui indique la bibliothèque de formulaires à ouvrir (autrement dit, le conteneur de formulaires à ouvrir). Une énumération HFRMREG est une énumération spécifique à un fournisseur de bibliothèque de formulaires. Les valeurs HFRMREG possibles sont les suivantes :
HFRMREG_DEFAULT
Conteneur de formulaire pratique.
HFRMREG_FOLDER
Conteneur de dossiers.
HFRMREG_PERSONAL
Conteneur de la banque de messages par défaut.
HFRMREG_LOCAL
Un conteneur de formulaire local.
lpunk
[in] Pointeur vers l’objet pour lequel l’interface est ouverte. Le paramètre lpunk doit être null , sauf si la valeur du paramètre hfrmreg nécessite un pointeur d’objet.
lppfcnt
[out] Pointeur vers un pointeur vers l’objet conteneur de formulaire retourné.
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
MAPI_E_NO_INTERFACE
L’objet pointé par lpunk ne prend pas en charge l’interface requise.
Les visionneuses de formulaires appellent la méthode IMAPIFormMgr ::OpenFormContainer pour ouvrir une interface IMAPIFormContainer pour un conteneur de formulaires spécifique. Cette interface peut ensuite être utilisée pour installer et supprimer des formulaires dans un conteneur de formulaires.
Si la valeur dans hfrmreg est HFRMREG_FOLDER, l’identificateur d’interface utilisé dans lpunk doit être non null et doit autoriser les appels de méthode IUnknown ::QueryInterface à une interface IMAPIFolder .
Pour ouvrir le conteneur de formulaires local, vous devez utiliser un appel à la méthode OpenFormContainer ou à la fonction MAPIOpenLocalFormContainer ; vous ne pouvez pas utiliser la méthode IMAPIFormMgr ::SelectFormContainer pour permettre à l’utilisateur de sélectionner le conteneur de formulaires local.
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
Fichier | Fonction | Commentaire |
---|---|---|
MainDlg.cpp |
CMainDlg ::OnOpenFormContainer |
MFCMAPI utilise la méthode IMAPIFormMgr ::OpenFormContainer pour récupérer un conteneur de formulaires afin que le contenu du conteneur puisse être rendu. |
MsgStoreDlg.cpp |
CMsgStoreDlg ::OnOpenFormContainer |
MFCMAPI utilise la méthode IMAPIFormMgr ::OpenFormContainer pour récupérer un conteneur de formulaires pour un dossier afin que le contenu du conteneur puisse être affiché. |
IMAPIFormContainer::InstallForm