ITnef::OpenTaggedBody
Hace referencia a: Outlook 2013 | Outlook 2016
Abre una interfaz de flujo en el texto de un mensaje encapsulado.
HRESULT OpenTaggedBody(
LPMESSAGE lpMessage,
ULONG ulFlags,
LPSTREAM FAR * lppStream
);
Parameters
lpMessage
[in] Puntero al mensaje con el que está asociada la secuencia. No es necesario que este mensaje sea el mismo que se pasa en la llamada a la función OpenTnefStream o OpenTnefStreamEx .
ulFlags
[in] Máscara de bits de marcas que controla cómo se abre la interfaz de flujo. Se pueden establecer las siguientes marcas:
MAPI_CREATE
Si una propiedad no existe en el mensaje actual, se debe crear. Si la propiedad existe, los datos actuales de la propiedad se deben reemplazar por los datos de la secuencia de formato de encapsulación (TNEF) de Transport-Neutral. Cuando una implementación establece la marca de MAPI_CREATE, también debe establecer la marca de MAPI_MODIFY.
MAPI_MODIFY
Solicita permiso de lectura y escritura. La interfaz predeterminada es de solo lectura. MAPI_MODIFY debe establecerse siempre que se establezca MAPI_CREATE.
lppStream
[out] Puntero a un puntero a un objeto de secuencia que contiene el texto de la propiedad PR_BODY (PidTagBody) del mensaje encapsulado pasado y que admite la interfaz IStream .
Valor devuelto
S_OK
La llamada se realizó correctamente y devolvió el valor o los valores esperados.
Comentarios
Los proveedores de transporte, los proveedores de almacén de mensajes y las puertas de enlace llaman al método ITnef::OpenTaggedBody para abrir una interfaz de flujo en el texto de un mensaje encapsulado (es decir, en un objeto TNEF).
Como parte de su procesamiento, OpenTaggedBody inserta o analiza etiquetas de datos adjuntos que indican la posición de los datos adjuntos u objetos OLE en el texto del mensaje. Las etiquetas de datos adjuntos tienen el formato siguiente:
[[nombre de datos adjuntos:nenel nombre del contenedor de datos adjuntos]]
el nombre de datos adjuntos describe el objeto de datos adjuntos; n es un número que identifica los datos adjuntos que forman parte de una secuencia, incrementando desde el valor pasado en el parámetro lpKey de la función OpenTnefStream o OpenTnefStreamEx ; y el nombre del contenedor de datos adjuntos describe el componente físico donde reside el objeto de datos adjuntos.
OpenTaggedBody lee el texto del mensaje e inserta una etiqueta de datos adjuntos siempre que un objeto de datos adjuntos apareciera originalmente en el texto. No se cambia el texto del mensaje original.
Cuando se pasa un mensaje que tiene etiquetas a una secuencia, las etiquetas se quitan y los objetos de datos adjuntos se reubican en la posición de las etiquetas de la secuencia.