CInternetSession:: OnStatusCallback

virtual void OnStatusCallback (DWORD dwContext, DWORD dwInternetStatus, LPVOID lpvStatusInformation, DWORD dwStatusInformationLength );

Parâmetros

dwContext

O valor de contexto fornecido pelo aplicativo.

dwInternetStatus

Um código de status que indica por que o retorno de chamada está sendo feito. Consulte comentários para uma tabela de valores possíveis.

lpvStatusInformation

Um ponteiro para uma reserva contendo informações pertinentes a esse retorno de chamada.

dwStatusInformationLength

O tamanho da lpvStatusInformation.

Observações

Esta fu&nção de membro é chamada pela estrutura para atualizar o status quando o retorno de chamada de status está habilitado e uma operação está pendente. Primeiro você deve chamar EnableStatusCallback para aproveitar do estatuto callback.nbsp;

O parâmetro dwInternetStatus indica a operação que está sendo executada e determina qual será o conteúdo de lpvStatusInformation . dwStatusInformationLength indica o comprimento dos dados incluídos no lpvStatusInformation. Os seguintes valores de status para dwInternetStatus estão definidos como segue:

Valor Significado
INTERNET_STATUS_RESOLVING_NAME Procurando o endereço IP do nome contido na lpvStatusInformation.
INTERNET_STATUS_NAME_RESOLVED Encontrado com êxito o endereço IP do nome contido na lpvStatusInformation.
INTERNET_STATUS_CONNECTING_TO_SERVER Conectando-se ao endereço de soquete (SOCKADDR) apontado pelo lpvStatusInformation.
INTERNET_STATUS_CONNECTED_TO_SERVER Com êxito conectado para o endereço de soquete (SOCKADDR) apontado pelo lpvStatusInformation.
INTERNET_STATUS_SENDING_REQUEST Enviando o pedido de informação para o servidor. O parâmetro lpvStatusInformation é NULL.
REQUEST_SENT REQUEST_SENT Enviado com êxito a solicitação de informações para o servidor. O parâmetro lpvStatusInformation é NULL.
INTERNET_STATUS_RECEIVING_RESPONSE Aguardando o servidor responder a uma solicitação. O parâmetro lpvStatusInformation é NULL.
INTERNET_STATUS_RESPONSE_RECEIVED Com êxito recebeu uma resposta do servidor. O parâmetro lpvStatusInformation é NULL.
INTERNET_STATUS_CLOSING_CONNECTION Fechando a conexão com o servidor. O parâmetro lpvStatusInformation é NULL.
INTERNET_STATUS_CONNECTION_CLOSED Com êxito fechou a conexão para o servidor. O parâmetro lpvStatusInformation é NULL.
INTERNET_STATUS_HANDLE_CREATED Usado pela função de API do Win32 InternetConnect para indicar que ele criou o novo identificador. Isso permite que a função de chamada Win32 aplicativo InternetCloseHandle de outro thread se conectar está demorando muito. Consulte o SDK do ActiveX para obter mais informações sobre essas funções.
INTERNET_STATUS_HANDLE_CLOSING Terminada com êxito esse valor identificador.
INTERNET_STATUS_REQUEST_COMPLETE Concluiu com êxito a operação assíncrona. Consulte o Construtor de CInternetSession para obter detalhes sobre INTERNET_FLAG_ASYNC.Os pontos de parâmetro lpvStatusInformation em uma estrutura INTERNET_ASYNC_RESULT e dwStatusInformationLength contém o status de conclusão finais da função assíncrona. Se este for ERROR_INTERNET_EXTENDED_ERROR, o aplicativo pode recuperar as informações de erro do servidor, usando a função Win32 InternetGetLastResponseInfo. Consulte o SDK do ActiveX para obter mais informações sobre esta função.

No caso de INTERNET_STATUS_REQUEST_COMPLETE, lpvStatusInformation pontos a uma estrutura INTERNET_ASYNC_RESULT , que é definido como:

Substituir esta função de membro para exigir alguma ação antes de uma rotina de retorno de chamada de status é executada.

&Notanbsp;  Retornos de chamada de status precisam proteção de estado do segmento. Se você estiver usando o MFC em uma biblioteca compartilhada, adicione a seguinte linha para o início de sua Substituir:

AFX_MANAGE_STATE (AfxGetAppModuleState ())

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::EnableStatusCallback, CInternetSession::GetContext

Index