Compartilhar via


CInternetSession::EnableStatusCallback

Chamar essa função de membro para ativar o retorno de chamada de status.

BOOL EnableStatusCallback( 
   BOOL bEnable = TRUE  
);

Parâmetros

  • bEnable
    Especifica se o retorno de chamada é ativado ou desativado. O padrão é Verdadeiro.

Valor de retorno

Diferente de zero se com êxito; se não 0. Se a chamada falha, determinar a causa de falha examinando o objeto de CInternetException lançada.

Comentários

A o manipular o retorno de chamada de status, você pode fornecer o status sobre o andamento da operação (como resolver o nome, conectando-se ao servidor, e assim por diante) na barra de status do aplicativo. Exibir o status da operação é especialmente desejável durante uma operação de longo prazo.

Porque as callbacks ocorrem durante o processamento de solicitação, o aplicativo deve passar tão poucas hora como possível no retorno de chamada evitar degradação de produção de dados à rede. Por exemplo, coloque em uma caixa de diálogo em um retorno de chamada pode ser uma operação tão longa que o servidor finaliza a solicitação.

O retorno de chamada de status não pode ser removido desde que todos as callbacks são pendentes.

Para manipular de forma assíncrona todas as operações, você deve criar seu próprio thread ou usar as funções de WinInet sem MFC.

Exceções

Esse método pode lançar exceções do tipo CInternetException*.

Requisitos

Cabeçalho: afxinet.h

Consulte também

Referência

Classe CInternetSession

Gráfico da hierarquia

CInternetSession::CInternetSession