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

Статья
11/20/2024

Задает параметр Интернета.

Синтаксис

BOOL InternetSetOptionA(
  [in] HINTERNET hInternet,
  [in] DWORD     dwOption,
  [in] LPVOID    lpBuffer,
  [in] DWORD     dwBufferLength
);

Параметры

[in] hInternet

Дескриптор, для которого необходимо задать сведения.

[in] dwOption

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

[in] lpBuffer

Указатель на буфер, содержащий параметр параметра.

[in] dwBufferLength

Размер буфера lpBuffer. Если lpBuffer содержит строку, размер находится в TCHARs. Если lpBuffer содержит что-либо, отличное от строки, размер находится в байтах.

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

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

Замечания

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

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

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

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

Заметка

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

Требования

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