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

Статья
03/04/2024

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

Синтаксис

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

Параметры

[in] hInternet

Дескриптор, по которому запрашиваться информация.

[in] dwOption

Параметр Internet для запроса. Это может быть одно из значений флагов параметров .

[out] lpBuffer

Указатель на буфер, который получает параметр . Строки, возвращаемые InternetQueryOption , выделяются глобально, поэтому вызывающее приложение должно освободить их после завершения использования.

[in, out] lpdwBufferLength

Указатель на переменную, содержащую размер lpBuffer в байтах. Когда InternetQueryOption возвращает значение , lpdwBufferLength указывает размер данных, помещенных в lpBuffer. Если GetLastError возвращает ERROR_INSUFFICIENT_BUFFER, этот параметр указывает на количество байтов, необходимых для хранения запрошенных сведений.

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

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

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

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wininet.h
Библиотека	Wininet.lib
DLL	Wininet.dll