共用方式為


InternetQueryOptionA 函式 (wininet.h)

查詢指定句柄上的因特網選項。

語法

BOOL InternetQueryOptionA(
  [in]      HINTERNET hInternet,
  [in]      DWORD     dwOption,
  [out]     LPVOID    lpBuffer,
  [in, out] LPDWORD   lpdwBufferLength
);

參數

[in] hInternet

處理要查詢信息的資訊。

[in] dwOption

要查詢的因特網選項。 這可以是其中一個 選項旗標 值。

[out] lpBuffer

接收選項設定之緩衝區的指標。 InternetQueryOption 所傳回的字串會全域配置,因此呼叫端應用程式在使用完畢時必須釋放它們。

[in, out] lpdwBufferLength

包含 lpBuffer 大小的變數指標,以位元組為單位。 當 InternetQueryOption 傳回時, lpdwBufferLength 會指定放入 lpBuffer 的數據大小。 如果 GetLastError 傳回ERROR_INSUFFICIENT_BUFFER,此參數會指向保存要求資訊所需的位元組數目。

傳回值

如果成功,則傳回 TRUE ,否則傳回 FALSE 。 若要取得特定的錯誤訊息,請呼叫 GetLastError

備註

如果指定的句柄類型無效的選項旗標傳遞至 dwOption 參數,GetLastError 會傳回ERROR_INVALID_PARAMETER

如需相關資訊,請參閱
設定和擷取因特網選項

就像 WinINet API 所有其他層面一樣,您無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。

注意 WinINet 不支援伺服器實作。 此外,不應該從服務使用它。 對於伺服器實作或服務,請使用 Microsoft Windows HTTP Services (WinHTTP)
 

注意

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

規格需求

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

另請參閱

一般函式

FtpGetFile

FtpPutFile

InternetConnect

InternetOpen

InternetSetOption

WinINet 函式