InternetQueryOption

This function queries an Internet option on the specified handle.

BOOL WINAPI InternetQueryOption(
HINTERNET hInternet , 
DWORD dwOption,  
LPVOID lpBuffer  OPTIONAL, 
LPDWORD lpdwBufferLength);

Parameters

  • hInternet
    Internet handle on which to query information.
  • dwOption
    Specifies the Internet option to query. Can be one of the Option Flags values.
  • lpBuffer
    Long pointer to a buffer that receives the option setting.
  • lpdwBufferLength
    Long pointer to a variable that contains the length of lpBuffer. When the function returns, the variable receives the length of the data placed into lpBuffer. If GetLastError returns ERROR_INSUFFICIENT_BUFFER, this parameter receives the number of bytes required to hold the created URL.

Return Values

TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError.

Windows CE Remarks

The following options may be queried through dwOption:

  • INTERNET_QUERY_OPTION_CALLBACK
  • INTERNET_OPTION_CONTEXT_VALUE
  • INTERNET_OPTION_CONNECT_TIMEOUT
  • INTERNET_OPTION_CONNECT_RETRIES
  • INTERNET_OPTION_CONNECT_BACKOFF
  • INTERNET_OPTION_CONTROL_SEND_TIMEOUT
  • INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT
  • INTERNET_OPTION_DATA_SEND_TIMEOUT
  • INTERNET_OPTION_DATA_RECEIVE_TIMEOUT
  • INTERNET_OPTION_READ_BUFFER_SIZE
  • INTERNET_OPTION_WRITE_BUFFER_SIZE
  • INTERNET_OPTION_USERNAME
  • INTERNET_OPTION_PASSWORD
  • INTERNET_OPTION_PROXY
  • INTERNET_OPTION_USER_AGENT
  • INTERNET_OPTION_HANDLE_TYPE
  • INTERNET_OPTION_PARENT_HANDLE

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Wininet.h   Wininet.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

FtpGetFile, FtpPutFile, GetLastError, InternetConnect, InternetOpen, InternetSetOption

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.