Функция ResumeSuspendedDownload (wininet.h)

Статья
08/27/2023

Функция ResumeSuspendedDownload возобновляет запрос, приостановленный диалоговым окном пользовательского интерфейса.

Синтаксис

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

Параметры

[in] hRequest

Дескриптор запроса, приостановленного диалоговым окном пользовательского интерфейса.

[in] dwResultCode

Результат ошибки, возвращенный из InternetErrorDlg, или ноль, если вызывается другой диалог.

Возвращаемое значение

В случае успешного выполнения возвращает значение TRUE ; В противном случае — FALSE. Вызовите GetLastError для получения расширенных сведений об ошибке.

Приложения, использующие функции WinINet асинхронно, могут вызывать ResumeSuspendedDownload для возобновления запроса, приостановленного диалоговым окном пользовательского интерфейса.

Например, вызовите ResumeSuspendedDownload после вызова InternetErrorDlg или в функции InternetStatusCallback , если параметр lpvStatusInformation равен INTERNET_STATUS_USER_INPUT_REQUIRED. В следующем примере кода показано, как использовать функцию ResumeSuspendedDownload в обратном вызове.

Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из DllMain или конструкторов и деструкторов глобальных объектов.

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для серверных реализаций или служб используйте службы Microsoft Windows HTTP (WinHTTP).

Примеры

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;
}

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wininet.h
Библиотека	Wininet.lib
DLL	Wininet.dll

См. также раздел

InternetErrorDlg

InternetStatusCallback

Поделиться через