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

Статья
11/20/2024

Функция InternetSetCookieEx создает файл cookie с указанным именем, связанным с указанным URL-адресом. Эта функция отличается от функции InternetSetCookie путем создания сторонних файлов cookie.

Синтаксис

DWORD InternetSetCookieExA(
  [in] LPCSTR    lpszUrl,
  [in] LPCSTR    lpszCookieName,
  [in] LPCSTR    lpszCookieData,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwReserved
);

Параметры

[in] lpszUrl

Указатель на строку null-terminated, содержащую URL-адрес, для которого должен быть задан файл cookie.

Если этот указатель NULL, InternetSetCookieEx завершается ошибкой ERROR_INVALID_PARAMETER.

[in] lpszCookieName

Указатель на строку null-terminated, содержащую имя, которое необходимо связать с этим файлом cookie. Если этот указатель null, имя не связано с файлом cookie.

[in] lpszCookieData

Указатель на строку null-terminated, содержащую данные, связанные с новым файлом cookie.

Если этот указатель NULL, InternetSetCookieEx завершается ошибкой ERROR_INVALID_PARAMETER.

[in] dwFlags

Флаги, управляющие получением данных cookie функции:

Ценность	Значение
INTERNET_COOKIE_EVALUATE_P3P	Если этот флаг задан, а параметр dwReserved не NULL, то параметр dwReserved приведение к LPCTSTR, который указывает на заголовок platform-for-Privacy-Protection (P3P) для файла cookie.
INTERNET_COOKIE_HTTPONLY	Включает получение файлов cookie, помеченных как HTTPOnly. Не используйте этот флаг, если вы предоставляете скриптируемый интерфейс, так как это влияет на безопасность. Если вы предоставляете скриптируемый интерфейс, вы можете стать вектором атаки для межсайтовых сценариев. Это совершенно императивно, что этот флаг используется только в том случае, если они могут гарантировать, что сторонний код никогда не позволит задать файл cookie с помощью этого флага с помощью предоставленного механизма расширяемости. версии: требуется Internet Explorer 8.0 или более поздней версии.
INTERNET_COOKIE_THIRD_PARTY	Указывает, что заданный файл cookie является сторонним файлом cookie.
INTERNET_FLAG_RESTRICTED_ZONE	Указывает, что заданный файл cookie связан с ненадежным сайтом.

[in] dwReserved

nullили содержит указатель на заголовок platform-for-Privacy-Protection (P3P), связанный с файлом cookie.

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

Возвращает элемент перечисления InternetCookieState в случае успешного выполнения или FALSE, если функция завершается ошибкой. При сбое, если вызов GetLastError возвращает ERROR_NOT_ENOUGH_MEMORY, недостаточно системной памяти.

Замечания

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

Заметка

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

Требования

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