IXPLogon::ValidateState
Aplica-se a: Outlook 2013 | Outlook 2016
Verifica o status externo do provedor de transporte.
HRESULT ValidateState(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parâmetros
ulUIParam
[in] Um identificador para a janela pai de qualquer caixa de diálogo ou janelas que este método exibe.
ulFlags
[in] Um bitmask de sinalizadores que controla como o status marcar é executado e os resultados do status marcar. Os seguintes sinalizadores podem ser definidos:
ABORT_XP_HEADER_OPERATION
O usuário cancelou a operação, normalmente clicando no botão Cancelar em uma caixa de diálogo. O provedor de transporte tem a opção de continuar trabalhando na operação ou pode cancelar a operação e retornar MAPI_E_USER_CANCELED.
CONFIG_CHANGED
Valida o estado dos provedores de transporte atualmente carregados fazendo com que o spooler MAPI chame o método IXPLogon::AddressTypes . Esse sinalizador também fornece ao spooler MAPI uma oportunidade de corrigir falhas críticas do provedor de transporte sem forçar os aplicativos cliente a fazer logon e fazer logon novamente.
FORCE_XP_CONNECT
O usuário selecionou uma operação de conexão. Quando esse sinalizador é usado com o sinalizador REFRESH_XP_HEADER_CACHE ou PROCESS_XP_HEADER_CACHE, a ação de conexão ocorre sem cache.
FORCE_XP_DISCONNECT
O usuário selecionou uma operação de desconexão. Quando esse sinalizador é usado com REFRESH_XP_HEADER_CACHE ou PROCESS_XP_HEADER_CACHE, a ação de desconexão ocorre sem cache.
PROCESS_XP_HEADER_CACHE
As entradas na tabela de cache de cabeçalho devem ser processadas, todas as mensagens marcadas com o sinalizador MSGSTATUS_REMOTE_DOWNLOAD devem ser baixadas e todas as mensagens marcadas com o sinalizador MSGSTATUS_REMOTE_DELETE devem ser excluídas. As mensagens que têm MSGSTATUS_REMOTE_DOWNLOAD e MSGSTATUS_REMOTE_DELETE definidas devem ser movidas.
REFRESH_XP_HEADER_CACHE
Uma nova lista de cabeçalhos de mensagem deve ser baixada e todas as mensagens status sinalizadores de marcação devem ser limpas.
SUPPRESS_UI
Impede que o provedor de transporte exiba uma interface do usuário.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
MAPI_E_BUSY
Outra operação está em andamento; ela deve ser autorizada a ser concluída ou deve ser interrompida antes que essa operação seja tentada.
MAPI_E_NO_SUPPORT
O provedor de transporte remoto envolvido não dá suporte a uma interface do usuário e o próprio aplicativo cliente deve exibir a caixa de diálogo.
MAPI_E_USER_CANCEL
O usuário cancelou a operação, normalmente clicando no botão Cancelar em uma caixa de diálogo.
Comentários
O spooler MAPI chama o método IXPLogon::ValidateState para dar suporte a chamadas para o método IMAPIStatus::ValidateState para o objeto status. O provedor de transporte deve responder à chamada IXPLogon::ValidateState exatamente como se o spooler MAPI tivesse aberto um objeto status para a sessão de logon atual e, em seguida, chamado IMAPIStatus::ValidateState nesse objeto.
Para dar suporte à implementação do IMAPIStatus::ValidateState, o spooler MAPI chama IXPLogon::ValidateState em todos os objetos de logon para todos os provedores de transporte ativos que estão em execução em uma sessão de perfil.