共用方式為

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 Services (WinHTTP) 。
 

注意

wininet.h 標頭會將 InternetReadFileEx 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 wininet.h
程式庫 Wininet.lib
Dll Wininet.dll

另請參閱

一般函式

WinINet 函式