InternetQueryOptionA 函式 (wininet.h)

發行項
03/13/2024

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

語法

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