Funzione ResumeSuspendedDownload (wininet.h)

Articolo
03/08/2023

La funzione ResumeSuspendedDownload riprende una richiesta sospesa da una finestra di dialogo dell'interfaccia utente.

Sintassi

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

Parametri

[in] hRequest

Handle della richiesta sospesa da una finestra di dialogo dell'interfaccia utente.

[in] dwResultCode

Il risultato dell'errore restituito da InternetErrorDlg o zero se viene richiamato un dialogo diverso.

Valore restituito

Restituisce TRUE se l'operazione riesce; in caso contrario FALSE. Chiamare GetLastError per informazioni sugli errori estese.

Commenti

Le applicazioni che usano funzioni WinINet in modo asincrono possono chiamare ResumeSuspendedDownload per riprendere una richiesta sospesa da una finestra di dialogo dell'interfaccia utente.

Ad esempio, chiamare ResumeSuspendedDownload dopo una chiamata a InternetErrorDlg o in una funzione InternetStatusCallback quando il parametro lpvStatusInformation è uguale a INTERNET_STATUS_USER_INPUT_REQUIRED. Nell'esempio di codice seguente viene illustrato come usare la funzione ResumeSuspendedDownload in un callback.

Come tutti gli altri aspetti dell'API WinINet, questa funzione non può essere chiamata in modo sicuro da DllMain o dai costruttori e distruttori di oggetti globali.

Nota WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni del server o i servizi, usare i servizi HTTP di Microsoft Windows (WinHTTP).

Esempio

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wininet.h
Libreria	Wininet.lib
DLL	Wininet.dll

Vedi anche

InternetErrorDlg

InternetStatusCallback

Condividi tramite