IMAPISupport::StatusRecips
Hace referencia a: Outlook 2013 | Outlook 2016
Genera informes de entrega y no entrega.
HRESULT StatusRecips(
LPMESSAGE lpMessage,
LPADRLIST lpRecipList
);
Parameters
lpMessage
[in] Puntero al mensaje para el que se debe generar el informe.
lpRecipList
[in] Puntero a una estructura ADRLIST que describe los destinatarios del mensaje al que apunta lpMessage.
Valor devuelto
S_OK
El informe se generó correctamente.
MAPI_W_ERRORS_RETURNED
La llamada se realizó correctamente en general, pero no hay opciones de destinatario para este tipo de destinatario. Cuando se devuelve esta advertencia, la llamada debe controlarse correctamente. Para probar esta advertencia, use la macro HR_FAILED . Para obtener más información, vea Uso de macros para el control de errores.
Comentarios
El método IMAPISupport::StatusRecips se implementa para los objetos de soporte técnico del proveedor de transporte. Los proveedores de transporte llaman a StatusRecips para solicitar que MAPI envíe un informe de entrega o no entrega a un conjunto de uno o varios de los destinatarios de un mensaje.
Notas para los llamadores
Puede llamar a StatusRecips varias veces durante el procesamiento de un mensaje. Sin embargo, si llama a StatusRecips para un mensaje abierto, haga todo lo posible para recopilar toda la información de entrega y no entrega de los destinatarios del mensaje y llame a StatusRecips para esa lista de destinatarios. Un único punto de recopilación es importante, ya que varias llamadas a StatusRecips para un destinatario pueden dar lugar a que se envíen varios informes idénticos.
Almacene las propiedades relacionadas con la entrega de mensajes o la no entrega en la estructura ADRLIST indicada por el parámetro lpRecipList . Para obtener una lista completa de las propiedades necesarias y opcionales para los informes de entrega y los informes no entregados, vea Propiedades de mensaje de informe obligatorio y Propiedades opcionales del mensaje de informe.
Asigne memoria para la estructura ADRLIST en lpRecipList mediante las funciones MAPIAllocateBuffer y MAPIAllocateMore . MAPI libera la memoria llamando a la función MAPIFreeBuffer solo si StatusRecips se realiza correctamente.
Para obtener información general sobre los informes de entrega y no entrega, vea Mensajes de informe MAPI.