CInternetSession::EnableStatusCallback

BOOL EnableStatusCallback (BOOL bEnable = VERDADEIRO);
Lançar (CInternetException);

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário 0. Se a chamada falhar, determinar a causa da falha, examinando o objeto de CInternetException gerado.

Parâmetros

bEnable

Especifica se o retorno de chamada está habilitado ou desabilitado. O padrão é TRUE.

Observações

Chame essa função de membro para habilitar callback status. Quando manipulação callback status, você pode fornecer o status sobre o progresso da operação (tais como resolução de nome, conectando-se ao servidor e assim por diante) na barra de status do aplicativo. Exibir o status de operação é especialmente desejável durante uma operação de longo prazo.

Você pode definir uma rotina de retorno de chamada para operações síncronas; no entanto, você deve estabelecer uma rotina de retorno de chamada para operações assíncronas porque a API assíncrona faz um retorno de chamada com INTERNET_STATUS_REQUEST_COMPLETE para indicar que a solicitação foi concluída.

Um retorno de chamada de uma operação assíncrona será em um thread diferente para o original solicitação. A chamada pode falhar com um erro ERROR_IO_PENDING se o pedido não estiver completo, quando ocorre o retorno de chamada de status. O retorno de chamada pode ser intitulado em um contexto de thread diferente do thread que iniciou a solicitação.

Como retornos de chamada ocorrerem durante o processamento da solicitação, o aplicativo deve gastar tempo tão pouco quanto possível no retorno de chamada para prevenir a degradação de throughput de dados à rede. Por exemplo, a colocação de uma caixa de diálogo em um retorno de chamada pode ser uma operação demorada que o servidor encerra o pedido.

A callback status não pode ser removida enquanto qualquer retornos de chamada ou quaisquer funções assíncronas estão pendentes.

&Notanbsp;  Para lidar com quaisquer operações de forma assíncrona, três condições devem ser definidas:

Para obter mais informações sobre operações assíncronas, consulte o artigo Internet primeiro etapas: WinInet no Guia do programador do Visual C++.

Visão geral de CInternetSession |nbsp; Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CInternetSession::CInternetSession

Index