IXPLogon::ValidateState
Hace referencia a: Outlook 2013 | Outlook 2016
Comprueba el estado externo del proveedor de transporte.
HRESULT ValidateState(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parameters
ulUIParam
[in] Identificador de la ventana primaria de los cuadros de diálogo o ventanas que muestra este método.
ulFlags
[in] Máscara de bits de marcas que controla cómo se realiza la comprobación de estado y los resultados de la comprobación de estado. Se pueden establecer las siguientes marcas:
ABORT_XP_HEADER_OPERATION
El usuario canceló la operación, normalmente haciendo clic en el botón Cancelar de un cuadro de diálogo. El proveedor de transporte tiene la opción de seguir trabajando en la operación o puede anular la operación y devolver MAPI_E_USER_CANCELED.
CONFIG_CHANGED
Valida el estado de los proveedores de transporte cargados actualmente haciendo que la cola MAPI llame a su método IXPLogon::AddressTypes . Esta marca también proporciona a la cola MAPI la oportunidad de corregir errores críticos del proveedor de transporte sin forzar a las aplicaciones cliente a cerrar sesión y, a continuación, iniciar sesión de nuevo.
FORCE_XP_CONNECT
El usuario seleccionó una operación de conexión. Cuando esta marca se usa con la marca REFRESH_XP_HEADER_CACHE o PROCESS_XP_HEADER_CACHE, la acción de conexión se produce sin almacenamiento en caché.
FORCE_XP_DISCONNECT
El usuario seleccionó una operación de desconexión. Cuando se usa esta marca con REFRESH_XP_HEADER_CACHE o PROCESS_XP_HEADER_CACHE, la acción de desconexión se produce sin almacenar en caché.
PROCESS_XP_HEADER_CACHE
Se deben procesar las entradas de la tabla de caché de encabezados, se deben descargar todos los mensajes marcados con la marca MSGSTATUS_REMOTE_DOWNLOAD y se deben eliminar todos los mensajes marcados con la marca MSGSTATUS_REMOTE_DELETE. Se deben mover los mensajes que tengan MSGSTATUS_REMOTE_DOWNLOAD y MSGSTATUS_REMOTE_DELETE establecidos.
REFRESH_XP_HEADER_CACHE
Se debe descargar una nueva lista de encabezados de mensaje y se deben borrar todas las marcas de marcado de estado de mensaje.
SUPPRESS_UI
Impide que el proveedor de transporte muestre una interfaz de usuario.
Valor devuelto
S_OK
La llamada se realizó correctamente y devolvió el valor o los valores esperados.
MAPI_E_BUSY
Hay otra operación en curso; se debe permitir que se complete o se debe detener antes de que se intente esta operación.
MAPI_E_NO_SUPPORT
El proveedor de transporte remoto implicado no admite una interfaz de usuario y la propia aplicación cliente debe mostrar el cuadro de diálogo.
MAPI_E_USER_CANCEL
El usuario canceló la operación, normalmente haciendo clic en el botón Cancelar de un cuadro de diálogo.
Comentarios
La cola MAPI llama al método IXPLogon::ValidateState para admitir llamadas al método IMAPIStatus::ValidateState para el objeto status. El proveedor de transporte debe responder a la llamada IXPLogon::ValidateState exactamente como si la cola MAPI hubiera abierto un objeto de estado para la sesión de inicio de sesión actual y, a continuación, se llamara IMAPIStatus::ValidateState en ese objeto.
Para admitir su implementación de IMAPIStatus::ValidateState, la cola MAPI llama a IXPLogon::ValidateState en todos los objetos de inicio de sesión de todos los proveedores de transporte activos que se ejecutan en una sesión de perfil.