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


структура XHR_COOKIE (msxml6.h)

Определяет файл cookie, который можно добавить в JAR-файл COOKIE HTTP, вызвав метод SetCookie , или получить из JAR-файла COOKIE HTTP, вызвав метод GetCookie .

Синтаксис

typedef struct tagXHR_COOKIE {
  WCHAR    *pwszUrl;
  WCHAR    *pwszName;
  WCHAR    *pwszValue;
  WCHAR    *pwszP3PPolicy;
  FILETIME ftExpires;
  DWORD    dwFlags;
} XHR_COOKIE;

Члены

pwszUrl

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

pwszName

Строка, завершающаяся значением NULL, указывающая имя в файле cookie.

pwszValue

Строка, завершающаяся нулевым значением, указывающая значение в файле cookie.

pwszP3PPolicy

Строка, завершающаяся нулевым значением, указывающая политику пользователя в файле cookie.

ftExpires

Строка, завершающаяся нулевым значением, которая указывает дату и время истечения срока действия файла cookie.

dwFlags

Набор битовых флагов, указывающий свойства файла cookie.

Этот элемент может быть одним из значений из типа перечисления XHR_COOKIE_FLAG, определенного в файле заголовка Msxml6.h .

Значение Значение
XHR_COOKIE_IS_SECURE
0x1
XHR_COOKIE_IS_SESSION
0x2
Файл cookie является файлом cookie сеанса, а не постоянным файлом cookie.
XHR_COOKIE_THIRD_PARTY
0x10
Указывает, что устанавливаемый файл cookie является сторонним файлом cookie.
XHR_COOKIE_PROMPT_REQUIRED
0x20
XHR_COOKIE_EVALUATE_P3P
0x40
Если этот флаг установлен, член pwszP3PPolicy указывает на заголовок P3P для файла cookie.
XHR_COOKIE_APPLY_P3P
0x80
XHR_COOKIE_APPLY_P3P
0x100
XHR_COOKIE_IS_RESTRICTED
0x200
Указывает, что устанавливаемый файл cookie связан с ненадежным сайтом.
XHR_COOKIE_IE6
0x400
XHR_COOKIE_IS_LEGACY
0x800
XHR_COOKIE_NON_SCRIPT
0x1000
XHR_COOKIE_HTTPONLY
0x2000
Включает получение файлов cookie, помеченных как "HTTPOnly".

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

Требования

Требование Значение
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP], MSXML 6.0 и более поздних версий
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Верхняя часть msxml6.h

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

Интерфейс IXMLHTTPRequest2

Метод SetCookie

Метод SetProperty