OpenIMsgSession

Hace referencia a: Outlook 2013 | Outlook 2016

Crea y abre una sesión de mensaje que agrupa los mensajes creados en ella.

Propiedad	Valor
Archivo de encabezado:	Imessage.h
Implementado por:	MAPI
Llamado por:	Aplicaciones cliente y proveedores de servicios

SCODE OpenIMsgSession(
  LPMALLOC lpMalloc,
  ULONG ulFlags,
  LPMSGSESS FAR * lppMsgSess
);

Parameters

lpMalloc

[in] Puntero a un objeto de asignador de memoria que expone la interfaz OLE IMalloc . MAPI debe usar este método de asignación al trabajar con la interfaz OLE IStorage .

ulFlags

[entrada] Reservado; debe ser cero.

lppMsgSess

[out] Puntero a un puntero al objeto de sesión de mensaje devuelto.

Valor devuelto

S_OK

Se abrió la sesión.

MAPI_E_INVALID_PARAMETER

lpMalloc o lppMsgSess es NULL.

MAPI_E_INVALID_FLAGS

Se pasaron marcas no válidas.

MAPI_UNICODE

Al llamar a esta función, un cliente o proveedor de servicios establece la marca de MAPI_UNICODE para crear archivos de .msg Unicode. El archivo Imessage resultante muestra STORE_UNICODE_OK en su PR_STORE_SUPPORT_MASK y admite propiedades Unicode.

Comentarios

Las aplicaciones cliente y los proveedores de servicios que quieren tratar varios objetos MAPI IMessage : IMAPIProp relacionados basados en objetos OLE IStorage subyacentes usan una sesión de mensaje. El cliente o proveedor usa las funciones OpenIMsgSession y CloseIMsgSession para encapsular la creación de dichos mensajes dentro de una sesión de mensajes. Una vez abierta la sesión del mensaje, el cliente o proveedor le pasa un puntero en una llamada a OpenIMsgOnIStg para crear un nuevo objeto IMessage-on-IStorage.

Una sesión de mensaje realiza un seguimiento de todos los objetos IMessage on-IStorage creados durante la sesión, además de todos los datos adjuntos y otras propiedades de los mensajes. Cuando un cliente o proveedor llama a CloseIMsgSession, cierra todos estos objetos. Llamar a CloseIMsgSession es la única manera de cerrar objetos IMessage-on-IStorage.

Los clientes y proveedores que requieren la capacidad de controlar varios mensajes relacionados como objetos OLE IStorage usan OpenIMsgSession. Si solo se va a abrir un mensaje de este tipo a la vez, no es necesario realizar un seguimiento de varios mensajes y ninguna razón para crear una sesión de mensaje con OpenIMsgSession.

Dado que se trata de un objeto OLE subyacente, MAPI debe usar la asignación de memoria OLE. Para obtener más información sobre los objetos de almacenamiento estructurado OLE y la asignación de memoria OLE, vea OLE y Transferencia de datos.