InternetReadFileExA 関数 (wininet.h)

  • [アーティクル]

InternetOpenUrl 関数または HttpOpenRequest 関数によって開かれたハンドルからデータを読み取ります。

構文

BOOL InternetReadFileExA(
  [in]  HINTERNET           hFile,
  [out] LPINTERNET_BUFFERSA lpBuffersOut,
  [in]  DWORD               dwFlags,
  [in]  DWORD_PTR           dwContext
);

パラメーター

[in] hFile

InternetOpenUrl または HttpOpenRequest 関数によって返されるハンドル。

[out] lpBuffersOut

ダウンロードされたデータを受信する INTERNET_BUFFERS 構造体へのポインター。

[in] dwFlags

このパラメーターには、次の値のいずれかを指定できます。

値 意味
IRF_ASYNC
 WININET_API_FLAG_ASYNCと同じです。
IRF_SYNC
 WININET_API_FLAG_SYNCと同じです。
IRF_USE_CONTEXT
 WININET_API_FLAG_USE_CONTEXTと同じです。
IRF_NO_WAIT
 データを待つ必要はありません。 使用可能なデータがある場合、関数は要求されたデータの量または使用可能なデータの量 (どちらか小さい方) を返します。

[in] dwContext

非同期操作に使用される呼び出し元が指定したコンテキスト値。

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 アプリケーションでは、必要に応じて InternetGetLastResponseInfo を使用することもできます。

注釈

メモ WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。
 

注意

wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetReadFileEx を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wininet.h
Library Wininet.lib
[DLL] Wininet.dll

こちらもご覧ください

一般的な関数

WinINet 関数