Partager via

OpenIMsgSession

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Crée et ouvre une session de messages qui regroupe les messages créés dans celle-ci.

Propriété Valeur
Fichier d’en-tête :
 Imessage.h
Implémenté par :
 MAPI
Appelé par :
 Applications clientes et fournisseurs de services
 
SCODE OpenIMsgSession(
  LPMALLOC lpMalloc,
  ULONG ulFlags,
  LPMSGSESS FAR * lppMsgSess
);

Paramètres

lpMalloc

[in] Pointeur vers un objet allocateur de mémoire exposant l’interface OLE IMalloc . MAPI doit utiliser cette méthode d’allocation lors de l’utilisation de l’interface OLE IStorage .

ulFlags

[in] R�serv� ; doit �tre �gal � z�ro.

lppMsgSess

[out] Pointeur vers un pointeur vers l’objet de session de message retourné.

Valeur renvoyée

S_OK

La session a été ouverte.

MAPI_E_INVALID_PARAMETER

lpMalloc ou lppMsgSess a la valeur NULL.

MAPI_E_INVALID_FLAGS

Des indicateurs non valides ont été passés.

MAPI_UNICODE

Lors de l’appel de cette fonction, un client ou un fournisseur de services définit l’indicateur MAPI_UNICODE pour créer des fichiers .msg Unicode. Le fichier Imessage obtenu affiche STORE_UNICODE_OK dans son PR_STORE_SUPPORT_MASK et prend en charge les propriétés Unicode.

Remarques

Une session de message est utilisée par les applications clientes et les fournisseurs de services qui souhaitent traiter plusieurs objets MAPI IMessage : IMAPIProp associés basés sur des objets OLE IStorage sous-jacents. Le client ou le fournisseur utilise les fonctions OpenIMsgSession et CloseIMsgSession pour encapsuler la création de ces messages à l’intérieur d’une session de messages. Une fois la session de message ouverte, le client ou le fournisseur lui transmet un pointeur dans un appel à OpenIMsgOnIStg pour créer un objet IMessage-on-IStorage.

Une session de messages effectue le suivi de tous les objets IMessage-on-IStorage créés pendant la durée de la session, en plus de toutes les pièces jointes et autres propriétés des messages. Lorsqu’un client ou un fournisseur appelle CloseIMsgSession, il ferme tous ces objets. L’appel de CloseIMsgSession est la seule façon de fermer des objets IMessage-on-IStorage.

OpenIMsgSession est utilisé par les clients et les fournisseurs qui nécessitent la possibilité de gérer plusieurs messages connexes en tant qu’objets OLE IStorage . Si un seul message de ce type doit être ouvert à la fois, il n’est pas nécessaire de suivre plusieurs messages et aucune raison de créer une session de message avec OpenIMsgSession.

Étant donné qu’il traite d’un objet OLE sous-jacent, MAPI doit utiliser l’allocation de mémoire OLE. Pour plus d’informations sur les objets de stockage structuré OLE et l’allocation de mémoire OLE, consultez OLE et transfert de données.