Fonction ResumeSuspendedDownload (wininet.h)

Article
03/04/2024

La fonction ResumeSuspendedDownload reprend une requête suspendue par une boîte de dialogue d’interface utilisateur.

Syntaxe

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

Paramètres

[in] hRequest

Handle de la demande suspendue par une boîte de dialogue d’interface utilisateur.

[in] dwResultCode

Résultat d’erreur retourné par InternetErrorDlg, ou zéro si une boîte de dialogue différente est appelée.

Valeur retournée

Retourne TRUE en cas de réussite ; sinon , FALSE. Appelez GetLastError pour obtenir des informations d’erreur étendues.

Remarques

Les applications qui utilisent des fonctions WinINet de manière asynchrone peuvent appeler ResumeSuspendedDownload pour reprendre une demande suspendue par une boîte de dialogue d’interface utilisateur.

Par exemple, appelez ResumeSuspendedDownload après un appel à InternetErrorDlg, ou dans une fonction InternetStatusCallback lorsque le paramètre lpvStatusInformation est égal à INTERNET_STATUS_USER_INPUT_REQUIRED. L’exemple de code suivant vous montre comment utiliser la fonction ResumeSuspendedDownload dans un rappel.

Comme tous les autres aspects de l’API WinINet, cette fonction ne peut pas être appelée en toute sécurité à partir de DllMain ou des constructeurs et destructeurs d’objets globaux.

Note WinINet ne prend pas en charge les implémentations de serveur. En outre, il ne doit pas être utilisé à partir d’un service. Pour les implémentations de serveur ou les services, utilisez Microsoft Windows HTTP Services (WinHTTP).

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wininet.h
Bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

InternetErrorDlg

InternetStatusCallback

Partager via