InternetQueryOptionW 函式（wininet.h）

發行項
11/20/2024

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

語法

BOOL InternetQueryOptionW(
  [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 true，否則會 傳回 false。若要取得特定錯誤訊息，請呼叫 GetLastError。

言論

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

如需詳細資訊，請參閱
設定和擷取因特網選項。

如同 WinINet API 的其他所有層面，無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。

注意 WinINet 不支援伺服器實作。此外，不應該從服務使用。針對伺服器實作或服務，請使用 Microsoft Windows HTTP 服務（WinHTTP）。

注意

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

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	wininet.h
連結庫	Wininet.lib
DLL	Wininet.dll