Compartilhar via


CInternetSession::OnStatusCallback

Essa função de membro é chamada pela estrutura para atualizar o status enquanto o retorno de chamada de status é habilitado e uma operação está pendente.

virtual void OnStatusCallback( 
   DWORD_PTR 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 como o retorno de chamada está sendo feito. Consulte Comentários para uma tabela de valores possíveis.

  • lpvStatusInformation
    Um ponteiro para um buffer que contém informações pertinentes à esse retorno de chamada.

  • dwStatusInformationLength
    o tamanho de lpvStatusInformation.

Comentários

Você deve primeiro chamar EnableStatusCallback aproveitar o retorno de chamada de status.

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

Valor

Significado

INTERNET_STATUS_RESOLVING_NAME

Pesquisando o endereço IP de nome contido em lpvStatusInformation.

INTERNET_STATUS_NAME_RESOLVED

Funde com êxito o endereço IP de nome contido em lpvStatusInformation.

INTERNET_STATUS_CONNECTING_TO_SERVER

Se conectar ao endereço de soquete (SOCKADDR) apontado por lpvStatusInformation.

INTERNET_STATUS_CONNECTED_TO_SERVER

Conectado com êxito o endereço de soquete (SOCKADDR) apontado por lpvStatusInformation.

INTERNET_STATUS_SENDING_REQUEST

Enviando a solicitação de informações para o servidor. o parâmetro de lpvStatusInformation é NULO.

INTERNET_STATUS_ REQUEST_SENT

Enviados com êxito a solicitação de informações para o servidor. o parâmetro de lpvStatusInformation é NULO.

INTERNET_STATUS_RECEIVING_RESPONSE

Aguardando o servidor para responder a uma solicitação. o parâmetro de lpvStatusInformation é NULO.

INTERNET_STATUS_RESPONSE_RECEIVED

Recebeu com êxito uma resposta do servidor. o parâmetro de lpvStatusInformation é NULO.

INTERNET_STATUS_CLOSING_CONNECTION

Fechar a conexão com o servidor. o parâmetro de lpvStatusInformation é NULO.

INTERNET_STATUS_CONNECTION_CLOSED

Termina com êxito a conexão com o servidor. o parâmetro de lpvStatusInformation é NULO.

INTERNET_STATUS_HANDLE_CREATED

Usado pela função InternetConnect da API do Win32 para indicar que criou o novo identificador. Isso permite a chamada de aplicativo a função InternetCloseHandle Win32 de outro segmento se conectar está colocando muito longas. Consulte Windows SDKpara obter mais informações sobre essas funções.

INTERNET_STATUS_HANDLE_CLOSING

Foi finalizado com êxito este valor de manipular.

Substituir essa função de membro para exigir qualquer ação antes que uma rotina de retorno de chamada de status ser executada.

Dica

As callbacks de status precisam com proteção de estado.Se você estiver usando o MFC em uma biblioteca compartilhada, adicione a seguinte linha para o início da sua substituição:

AFX_MANAGE_STATE(AfxGetAppModuleState());

Para obter mais informações sobre as operações assíncronas, consulte o artigo Primeiras etapas da Internet: WinInet.

Requisitos

Cabeçalho: afxinet.h

Consulte também

Referência

Classe CInternetSession

Gráfico da hierarquia

CInternetSession::EnableStatusCallback

CInternetSession::GetContext