Поделиться через


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

Создает файл cookie, связанный с указанным URL-адресом.

Синтаксис

DWORD InternetSetCookieEx2(
  PCWSTR                 pcwszUrl,
  const INTERNET_COOKIE2 *pCookie,
  PCWSTR                 pcwszP3PPolicy,
  DWORD                  dwFlags,
  PDWORD                 pdwCookieState
);

Параметры

pcwszUrl

URL-адрес, для которого нужно задать файл cookie.

pCookie

Указатель на структуру INTERNET_COOKIE2 , содержащую данные файла cookie.

pcwszP3PPolicy

Строка, содержащая политику P3P для файла cookie. Может иметь значение "NULL".

dwFlags

Флаги для задания файла cookie. Доступны следующие флаги.

Значение Значение
INTERNET_COOKIE_THIRD_PARTY Задайте этот файл cookie в стороннем контексте.
INTERNET_COOKIE_PROMPT_REQUIRED Отображение запроса пользовательского интерфейса пользователя на принятие или отклонение этого файла cookie.
INTERNET_COOKIE_EVALUATE_P3P Оцените предоставленную политику P3P для этого файла cookie. Эта политика будет оцениваться по умолчанию, если pcwszP3PPolicy имеет значение NULL.
INTERNET_COOKIE_NON_SCRIPT Укажите, что этот файл cookie не настраивается с помощью JavaScript, что позволяет устанавливать файлы cookie, доступные только для HTTP.
INTERNET_COOKIE_APPLY_HOST_ONLY Примените политику только для узла к этому файлу cookie. Если атрибут домена не задан, этот файл cookie будет помечен как host-only.

pdwCookieState

Указатель на DWORD, получающий результат настройки файла cookie. Список возможных значений см. в разделе InternetCookieState.

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

Возвращает ERROR_SUCCESS в случае успешного выполнения или код системной ошибки при сбое.

Комментарии

Примечание

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

Требования

   
Минимальная версия клиента Windows 8.1 [только классические приложения]
Минимальная версия сервера Windows Server 2012 R2 [только классические приложения]
Верхняя часть wininet.h
Библиотека Wininet.lib
DLL Wininet.dll

См. также раздел

Файлы cookie HTTP

Управление файлами cookie

InternetGetCookieEx2

InternetFreeCookies

Функции WinINet