INTERNET_STATUS_CALLBACK função de retorno de chamada (wininet.h)
Protótipo de uma função de retorno de chamada status definida pelo aplicativo.
O tipo INTERNET_STATUS_CALLBACK define um ponteiro para essa função de retorno de chamada. InternetStatusCallback é um espaço reservado para o nome da função definida pelo aplicativo.
Sintaxe
INTERNET_STATUS_CALLBACK InternetStatusCallback;
void InternetStatusCallback(
[in] HINTERNET hInternet,
[in] DWORD_PTR dwContext,
[in] DWORD dwInternetStatus,
[in] LPVOID lpvStatusInformation,
[in] DWORD dwStatusInformationLength
)
{...}
Parâmetros
[in] hInternet
O identificador para o qual a função de retorno de chamada é chamada.
[in] dwContext
Um ponteiro para uma variável que especifica o valor de contexto definido pelo aplicativo associado ao hInternet.
[in] dwInternetStatus
Um código status que indica por que a função de retorno de chamada é chamada. Esse parâmetro pode usar um dos valores a seguir.
| Valor | Significado |
|---|---|
|
Encerrando a conexão com o servidor. O parâmetro lpvStatusInformation é NULL. |
|
Conectado com êxito ao endereço de soquete (SOCKADDR) apontado por lpvStatusInformation. |
|
Conectando-se ao endereço do soquete (SOCKADDR) apontado por lpvStatusInformation. |
|
Fechou com êxito a conexão com o servidor. O parâmetro lpvStatusInformation é NULL. |
|
Recuperando conteúdo do cache. Contém dados sobre eventos de cookie anteriores para a URL, como se os cookies fossem aceitos, rejeitados, rebaixados ou com coleira.
O parâmetro lpvStatusInformation é um ponteiro para uma estrutura InternetCookieHistory . |
|
Indica o número de cookies que foram aceitos, rejeitados, rebaixados (alterados de cookies persistentes para de sessão) ou com leashed (serão enviados somente no contexto de 1ª parte). O parâmetro lpvStatusInformation é um DWORD com o número de cookies recebidos. |
|
Indica o número de cookies que foram enviados ou suprimidos quando uma solicitação é enviada. O parâmetro lpvStatusInformation é um DWORD com o número de cookies enviados ou suprimidos. |
|
Não implementado. |
|
Notifica o aplicativo cliente de que um proxy foi detectado. |
|
Esse valor de identificador foi encerrado. pvStatusInformation contém o endereço do identificador que está sendo fechado. O parâmetro lpvStatusInformation contém o endereço do identificador que está sendo fechado. |
|
Usado por InternetConnect para indicar que ele criou o novo identificador. Isso permite que o aplicativo chame InternetCloseHandle de outro thread, se a conexão estiver demorando muito. O parâmetro lpvStatusInformation contém o endereço de um identificador HINTERNET . |
|
Recebeu uma mensagem de código intermediária (nível 100) status do servidor. |
|
Encontrou com êxito o endereço IP do nome contido em lpvStatusInformation. O parâmetro lpvStatusInformation aponta para um PCTSTR que contém o nome do host. |
|
A resposta tem um cabeçalho P3P. |
|
Não implementado. |
|
Não implementado. |
|
Não implementado. |
|
Aguardando o servidor responder a uma solicitação. O parâmetro lpvStatusInformation é NULL. |
|
Uma solicitação HTTP está prestes a redirecionar automaticamente a solicitação. O parâmetro lpvStatusInformation aponta para a nova URL. Neste ponto, o aplicativo pode ler todos os dados retornados pelo servidor com a resposta de redirecionamento e pode consultar os cabeçalhos de resposta. Ele também pode cancelar a operação fechando o identificador. Esse retorno de chamada não será feito se a solicitação original especificada INTERNET_FLAG_NO_AUTO_REDIRECT. |
|
Uma operação assíncrona foi concluída. O parâmetro lpvStatusInformation contém o endereço de uma estrutura INTERNET_ASYNC_RESULT . |
|
Enviou com êxito a solicitação de informações para o servidor. O parâmetro lpvStatusInformation aponta para um valor DWORD que contém o número de bytes enviados. |
|
Pesquisando o endereço IP do nome contido em lpvStatusInformation. O parâmetro lpvStatusInformation aponta para um PCTSTR que contém o nome do host. |
|
Recebeu com êxito uma resposta do servidor. |
|
Enviando a solicitação de informações para o servidor. O parâmetro lpvStatusInformation é NULL. |
|
Movido entre um site seguro (HTTPS) e um site não seguro (HTTP). O usuário deve ser informado dessa alteração; caso contrário, o usuário corre o risco de divulgar informações confidenciais involuntariamente. Quando esse sinalizador é definido, o parâmetro lpvStatusInformation aponta para um status DWORD que contém sinalizadores adicionais. |
[in] lpvStatusInformation
Um ponteiro para informações de status adicionais. Quando o sinalizador INTERNET_STATUS_STATE_CHANGE é definido, lpvStatusInformation aponta para um DWORD que contém um ou mais dos seguintes sinalizadores:
[in] dwStatusInformationLength
O tamanho, em bytes, dos dados apontados por lpvStatusInformation.
Retornar valor
Nenhum
Comentários
Como os retornos de chamada são feitos durante o processamento da solicitação, o aplicativo deve gastar pouco tempo na função de retorno de chamada para evitar a degradação da taxa de transferência de dados na rede. Por exemplo, exibir uma caixa de diálogo em uma função de retorno de chamada pode ser uma operação tão longa que o servidor encerra a solicitação.
A função de retorno de chamada pode ser chamada em um contexto de thread diferente do thread que iniciou a solicitação.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | wininet.h |