ResumeSuspendedDownload-Funktion (wininet.h)

Artikel
03/04/2024

Die ResumeSuspendedDownload-Funktion setzt eine Anforderung fort, die von einem Benutzeroberfläche-Dialogfeld angehalten wird.

Syntax

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

Parameter

[in] hRequest

Handle der Anforderung, die von einem Benutzeroberflächendialogfeld angehalten wird.

[in] dwResultCode

Das von InternetErrorDlg zurückgegebene Fehlerergebnis oder null, wenn ein anderes Dialogfeld aufgerufen wird.

Rückgabewert

Gibt TRUE zurück, wenn dies erfolgreich war. andernfalls FALSE. Rufen Sie GetLastError für erweiterte Fehlerinformationen auf.

Hinweise

Anwendungen, die WinINet-Funktionen asynchron verwenden, können ResumeSuspendedDownload aufrufen, um eine Anforderung fortzusetzen, die von einem Dialogfeld der Benutzeroberfläche angehalten wird.

Rufen Sie beispielsweise ResumeSuspendedDownload nach einem Aufruf von InternetErrorDlg oder in einer InternetStatusCallback-Funktion auf, wenn der lpvStatusInformation-Parametergleich INTERNET_STATUS_USER_INPUT_REQUIRED. Im folgenden Codebeispiel wird gezeigt, wie Sie die ResumeSuspendedDownload-Funktion in einem Rückruf verwenden.

Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.

Hinweis WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).

Beispiele

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wininet.h
Bibliothek	Wininet.lib
DLL	Wininet.dll

Weitere Informationen

InternetErrorDlg

InternetStatusCallback

Share via