IXPLogon::FlushQueues
Hace referencia a: Outlook 2013 | Outlook 2016
Solicita que el proveedor de transporte entregue inmediatamente todos los mensajes entrantes o salientes pendientes.
HRESULT FlushQueues(
ULONG_PTR ulUIParam,
ULONG cbTargetTransport,
LPENTRYID lpTargetTransport,
ULONG ulFlags
);
Parameters
ulUIParam
[in] Identificador de la ventana primaria de los cuadros de diálogo o ventanas que muestra este método.
cbTargetTransport
[entrada] Reservado; debe ser cero.
lpTargetTransport
[in] Reservados; debe ser NULL.
ulFlags
[in] Máscara de bits de marcas que controla cómo se realiza el vaciado de la cola de mensajes. Se pueden establecer las siguientes marcas:
FLUSH_DOWNLOAD
Las colas o cola de mensajes entrantes deben vaciarse.
FLUSH_FORCE
El proveedor de transporte debe procesar esta solicitud, si es posible, incluso si hacerlo lleva mucho tiempo.
FLUSH_NO_UI
El proveedor de transporte no debe mostrar una interfaz de usuario.
FLUSH_UPLOAD
Las colas o cola de mensajes salientes deben vaciarse.
Valor devuelto
S_OK
La llamada se realizó correctamente y devolvió el valor o los valores esperados.
Comentarios
La cola MAPI llama al método IXPLogon::FlushQueues para indicar al proveedor de transporte que la cola MAPI está a punto de empezar a procesar los mensajes. El proveedor de transporte debe llamar al método IMAPISupport::ModifyStatusRow para establecer un bit adecuado para su estado en la propiedad PR_STATUS_CODE (PidTagStatusCode) de su fila de estado. Después de actualizar su fila de estado, el proveedor de transporte debe devolver S_OK para la llamada FlushQueues . A continuación, la cola MAPI comienza a enviar mensajes, con la operación sincrónica a la cola MAPI.
Para admitir su implementación del método IMAPIStatus::FlushQueues , la cola MAPI llama a IXPLogon::FlushQueues para todos los objetos de inicio de sesión para los proveedores de transporte activos que se ejecutan en una sesión de perfil. Cuando se llama al método FlushQueues de un proveedor de transporte como resultado de una llamada de aplicación cliente a IMAPIStatus::FlushQueues, el procesamiento de mensajes se produce de forma asincrónica en el cliente.