ITnef::SetProps
Hace referencia a: Outlook 2013 | Outlook 2016
Establece el valor de una o varias propiedades para un mensaje encapsulado o datos adjuntos sin modificar el mensaje o los datos adjuntos originales.
HRESULT SetProps(
ULONG ulFlags,
ULONG ulElemID,
ULONG cValues,
LPSPropValue lpProps
);
Parameters
ulFlags
[in] Máscara de bits de marcas que controla cómo se establecen los valores de propiedad. Se puede establecer la marca siguiente:
TNEF_PROP_CONTAINED
Codifica solo las propiedades del mensaje o datos adjuntos especificados por el parámetro ulElemID .
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.
cValues
[in] Número de valores de propiedad en la estructura SPropValue a la que apunta el parámetro lpProps .
lpProps
[in] Puntero a una estructura SPropValue que contiene los valores de propiedad de las propiedades que se van a establecer.
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::SetProps para establecer las propiedades que se van a incluir en la encapsulación de un mensaje o datos adjuntos sin modificar el mensaje o los datos adjuntos originales. Las propiedades establecidas con esta llamada invalidan las propiedades existentes en el mensaje encapsulado.
SetProps solo se admite para objetos TNEF que se abren con la marca de TNEF_ENCODE para la función OpenTnefStream o OpenTnefStreamEx . Cualquier número de propiedades se puede establecer con esta llamada.
Nota:
No se produce ninguna codificación TNEF real para SetProps hasta que se llama al método ITnef::Finish . Esta funcionalidad significa que los punteros pasados a SetProps deben permanecer válidos hasta que se realice la llamada a Finish . En ese momento, todos los objetos y datos pasados a las llamadas SetProps se pueden liberar o liberar.