ResumeSuspendedDownload 関数 (wininet.h)

ResumeSuspendedDownload 関数は、ユーザー インターフェイス ダイアログ ボックスによって中断された要求を再開します。

構文

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

パラメーター

[in] hRequest

ユーザー インターフェイス ダイアログ ボックスによって中断される要求のハンドル。

[in] dwResultCode

InternetErrorDlg から返されるエラーの結果。別のダイアログが呼び出された場合は 0。

戻り値

成功した場合は TRUE を 返します。それ以外の場合 は FALSE。 拡張エラー情報については 、GetLastError を呼び出します。

注釈

WinINet 関数を非同期的に使用するアプリケーションは 、ResumeSuspendedDownload を呼び出して、ユーザー インターフェイス ダイアログ ボックスによって中断された要求を再開できます。

たとえば、InternetErrorDlg の呼び出し後に ResumeSuspendedDownload を呼び出すか、lpvStatusInformation パラメーターが INTERNET_STATUS_USER_INPUT_REQUIREDと等しい場合は InternetStatusCallback 関数で呼び出します。 次のコード例は、コールバックで ResumeSuspendedDownload 関数を使用する方法を示しています。

WinINet API の他のすべての側面と同様に、この関数を 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
ヘッダー	wininet.h
Library	Wininet.lib
[DLL]	Wininet.dll

こちらもご覧ください

InternetErrorDlg

InternetStatusCallback