Função ResumeSuspendedDownload (wininet.h)

  • Artigo

A função ResumeSuspendedDownload retoma uma solicitação suspensa por uma caixa de diálogo de interface do usuário.

Sintaxe

BOOL ResumeSuspendedDownload(
  [in] HINTERNET hRequest,
  [in] DWORD     dwResultCode
);

Parâmetros

[in] hRequest

Identificador da solicitação suspensa por uma caixa de diálogo de interface do usuário.

[in] dwResultCode

O resultado do erro retornado de InternetErrorDlg ou zero se uma caixa de diálogo diferente for invocada.

Retornar valor

Retorna TRUE se tiver êxito; caso contrário , FALSE. Chame GetLastError para obter informações de erro estendidas.

Comentários

Aplicativos que usam funções WinINet de forma assíncrona podem chamar ResumeSuspendedDownload para retomar uma solicitação suspensa por uma caixa de diálogo de interface do usuário.

Por exemplo, chame ResumeSuspendedDownload após uma chamada para InternetErrorDlg ou em uma função InternetStatusCallback quando o parâmetro lpvStatusInformation for igual a INTERNET_STATUS_USER_INPUT_REQUIRED. O exemplo de código a seguir mostra como usar a função ResumeSuspendedDownload em um retorno de chamada.

Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro de DllMain ou dos construtores e destruidores de objetos globais.

Nota O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações de servidor ou serviços, use Os Serviços HTTP do Microsoft Windows (WinHTTP).
 

Exemplos

void CALLBACK YourInternetStatusCallbackFunction(
    HINTERNET hInternet,
    DWORD_PTR dwContext,
    DWORD dwInternetStatus,
    LPVOID lpvStatusInformation
    DWORD dwStatusInformationLength )
{
//  [...other callback code here]

  switch (dwInternetStatus)
  {
//  [...handle other INTERNET_STATUS cases]

    case INTERNET_STATUS_USER_INPUT_REQUIRED:
      ResumeSuspendedDownload( hInternet, 0 );
      break;

//  [...handle other INTERNET_STATUS cases]

    default:
//    [...default code]
      break;
  }

  return;
}

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
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

InternetErrorDlg

InternetStatusCallback