Функция InternetQueryOptionA (wininet.h)

Статья
11/20/2024

Запрашивает параметр Internet в указанном дескрипторе.

Синтаксис

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, в байтах. При возвращении InternetQueryOptionlpdwBufferLength указывает размер данных, помещенных в lpBuffer. Если GetLastError возвращает ERROR_INSUFFICIENT_BUFFER, этот параметр указывает на количество байтов, необходимых для хранения запрошенных сведений.

Возвращаемое значение

Возвращает TRUE, если выполнено успешно или FALSE в противном случае. Чтобы получить определенное сообщение об ошибке, вызовите GetLastError.

Замечания

GetLastError вернет ERROR_INVALID_PARAMETER, если флаг параметра, недопустимый для указанного типа дескриптора, передается параметру dwOption.

Дополнительные сведения см. в разделе
настройка и получениепараметров браузера.

Как и все остальные аспекты API WinINet, эта функция не может быть безопасно вызвана из dllMain или конструкторов и деструкторов глобальных объектов.

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для реализации или служб сервера microsoft Windows HTTP Services (WinHTTP).

Заметка

Заголовок wininet.h определяет InternetQueryOption как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wininet.h
библиотеки	Wininet.lib
DLL	Wininet.dll