IMessage::CreateAttach
Hace referencia a: Outlook 2013 | Outlook 2016
Crea un nuevo archivo adjunto.
HRESULT CreateAttach(
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulAttachmentNum,
LPATTACH FAR * lppAttach
);
Parameters
lpInterface
[in] Puntero al identificador de interfaz (IID) que representa la interfaz que se va a usar para acceder al mensaje. Al pasar NULL, se devuelve la interfaz estándar del mensaje, o IMessage.
ulFlags
[in] Máscara de bits de marcas que controla cómo se crean los datos adjuntos. Se puede establecer la marca siguiente:
MAPI_DEFERRED_ERRORS
Permite que CreateAttach devuelva correctamente, posiblemente antes de que el cliente que realiza la llamada pueda acceder completamente a los datos adjuntos. Si no se puede acceder a los datos adjuntos, realizar una llamada posterior a él puede provocar un error.
lpulAttachmentNum
[out] Puntero a un número de índice que identifica los datos adjuntos recién creados. Este número solo es válido cuando el mensaje está abierto y es la base de la propiedad PR_ATTACH_NUM (PidTagAttachNumber) de los datos adjuntos.
lppAttach
[out] Puntero a un puntero al objeto de datos adjuntos abierto.
Valor devuelto
S_OK
Los datos adjuntos se crearon correctamente.
Comentarios
El método IMessage::CreateAttach crea un nuevo archivo adjunto en un mensaje. Los nuevos datos adjuntos y las propiedades que se establecen para él no están disponibles hasta que un cliente haya llamado al método IMAPIProp::SaveChanges de los datos adjuntos y al método IMAPIProp::SaveChanges del mensaje.
El número de datos adjuntos al que apunta lpulAttachmentNum es único y válido solo en el contexto del mensaje. Es decir, dos datos adjuntos en dos mensajes diferentes pueden tener el mismo número, mientras que dos datos adjuntos en el mismo mensaje no pueden.