IMAPIMessageSite::NewMessage

Article
04/04/2023

S’applique à : Outlook 2013 | Outlook 2016

Crée un message.

HRESULT NewMessage(
  ULONG fComposeInFolder,
  LPMAPIFOLDER pFolderFocus,
  LPPERSISTMESSAGE pPersistMessage,
  LPMESSAGE FAR * ppMessage,
  LPMAPIMESSAGESITE FAR * ppMessageSite,
  LPMAPIVIEWCONTEXT FAR * ppViewContext
);

Paramètres

fComposeInFolder

[in] Indique dans quel dossier le message doit être composé. Si la variable a la valeur FALSE, le paramètre pFolderFocus est ignoré et la visionneuse de formulaires peut composer le message dans n’importe quel dossier. Si la variable a la valeur TRUE et NULL est passée dans le paramètre pFolderFocus , le message est composé dans le dossier actif. Si la variable a la valeur TRUE et qu’une valeur non NULL est passée dans pFolderFocus, le message est composé dans le dossier désigné par pFolderFocus.

pFolderFocus

[in] Pointeur vers le dossier où le nouveau message est créé.

pPersistMessage

[in] Pointeur vers l’objet de formulaire pour le nouveau formulaire.

ppMessage

[out] Pointeur vers un pointeur vers le nouveau message.

ppMessageSite

[out] Pointeur vers un pointeur vers un objet de site de message pour le nouveau message.

ppViewContext

[out] Pointeur vers un contexte d’affichage approprié pour passer à un nouveau formulaire avec le nouveau message. Si le formulaire implémente son propre contexte d’affichage, null peut être passé dans le paramètre ppViewContext .

Valeur renvoyée

S_OK

L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.

Remarques

Les objets de formulaire appellent la méthode IMAPIMessageSite ::NewMessage pour créer un message. Le formulaire utilise NewMessage pour obtenir un nouveau message et le site de message associé à partir de sa vue. Il peut ensuite modifier le nouveau message.

Vous pouvez également obtenir un contexte d’affichage associé en transmettant une valeur non NULL dans le paramètre ppViewContext . Ce contexte d’affichage peut être utilisé directement, ou il peut être agrégé et passé au nouveau message. Si une implémentation complète est requise, passez NULL dans ppViewContext.

Pour obtenir la liste des interfaces liées aux serveurs de formulaires, consultez Interfaces de formulaire MAPI.

Référence MFCMAPI

Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.

Fichier	Fonction	Commentaire
MyMAPIFormViewer.cpp	CMyMAPIFormViewer ::NewMessage	MFCMAPI utilise la méthode IMAPIMessageSite ::NewMessage pour créer un message, instancier une visionneuse de formulaire et appeler SetPersist pour définir le message sur la visionneuse de formulaires. Enfin, elle renvoie la visionneuse de formulaire en tant que site de message.

Voir aussi

IMAPIViewContext : IUnknown

IMAPIMessageSite : IUnknown

MFCMAPI comme un exemple de Code

Interfaces de formulaire MAPI

Partager via