Функция InternetQueryOptionA (wininet.h)
Запрашивает параметр 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.
Комментарии
GetLastError возвращает ERROR_INVALID_PARAMETER , если параметру dwOption передается недопустимый флаг параметра для указанного типа дескриптора.
Дополнительные сведения см. в разделе
Настройка и получение параметров браузера.
Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из DllMain или конструкторов и деструкторов глобальных объектов.
Примечание
Заголовок wininet.h определяет InternetQueryOption как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wininet.h |
| Библиотека | Wininet.lib |
| DLL | Wininet.dll |