ITnef::AddProps

Artículo
04/04/2023

Hace referencia a: Outlook 2013 | Outlook 2016

Permite que el proveedor de servicios de llamada o la puerta de enlace agreguen propiedades a la encapsulación de un mensaje o datos adjuntos.

HRESULT AddProps(
  ULONG ulFlags,
  ULONG ulElemID,
  LPVOID lpvData,
  LPSPropTagArray lpPropList
);

Parameters

ulFlags

[in] Máscara de bits de marcas que controla cómo se incluyen o excluyen las propiedades de la encapsulación. Se pueden establecer las siguientes marcas:

TNEF_PROP_ATTACHMENTS_ONLY

Codifica solo las propiedades del parámetro lpPropList que forman parte de los datos adjuntos del mensaje.

TNEF_PROP_CONTAINED

Codifica solo las propiedades de los datos adjuntos especificados por el parámetro ulElemID . Si el parámetro lpvData no es NULL, los datos a los que apunta se escriben en la encapsulación de los datos adjuntos en el archivo indicado por la propiedad PR_ATTACH_TRANSPORT_NAME (PidTagAttachTransportName).

TNEF_PROP_CONTAINED_TNEF

Codifica solo las propiedades del mensaje o datos adjuntos especificados por el parámetro ulElemID . Si se establece esta marca, el valor de lpvData debe ser un puntero IStream .

TNEF_PROP_EXCLUDE

Codifica todas las propiedades no especificadas en el parámetro lpPropList .

TNEF_PROP_INCLUDE

Codifica todas las propiedades especificadas en lpPropList.

TNEF_PROP_MESSAGE_ONLY

Codifica solo las propiedades especificadas en lpPropList que forman parte del propio mensaje.

ulElemID

[in] Propiedad de PR_ATTACH_NUM de datos adjuntos (PidTagAttachNumber), que contiene un número que identifica de forma única los datos adjuntos en su mensaje primario. El parámetro ulElemID se usa cuando se solicita un control especial para los datos adjuntos. El parámetro ulElemID debe ser 0 a menos que se establezca la marca TNEF_PROP_CONTAINED o TNEF_PROP_CONTAINED_TNEF en el parámetro ulFlags .

lpvData

[in] Puntero a los datos adjuntos que se usan para reemplazar los datos de los datos adjuntos especificados en ulElemID. El parámetro lpvData debe ser NULL a menos que se establezca TNEF_PROP_CONTAINED o TNEF_PROP_CONTAINED_TNEF en ulFlags.

lpPropList

[in] Puntero a la lista de propiedades que se incluirán o excluirán de la encapsulación.

Valor devuelto

S_OK

La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.

Comentarios

Los proveedores de transporte, los proveedores de almacén de mensajes y las puertas de enlace llaman al método ITnef::AddProps para enumerar las propiedades que se incluirán o excluirán del procesamiento de formato de encapsulación de Transport-Neutral (TNEF) de un mensaje o datos adjuntos. Mediante el uso de llamadas sucesivas, el proveedor o la puerta de enlace pueden especificar una lista de propiedades para agregar y codificar o excluir de la codificación. Los proveedores y puertas de enlace también pueden usar AddProps para proporcionar información sobre los datos adjuntos de control especiales que se deben proporcionar.

AddProps solo se admite para objetos TNEF que se abren con la marca TNEF_ENCODE para la función OpenTnefStream o OpenTnefStreamEx .

Tenga en cuenta que no se produce ninguna codificación TNEF real para AddProps hasta que se llama al método ITnef::Finish . Esta funcionalidad significa que los punteros pasados a AddProps deben permanecer válidos hasta que se realice la llamada a Finish . En ese momento, todos los objetos y datos pasados con llamadas AddProps se pueden liberar o liberar.