Метод IXMLHTTPRequest2::SetCookie (msxml6.h)

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

Синтаксис

HRESULT SetCookie(
  const XHR_COOKIE *pCookie,
  DWORD            *pdwCookieState
);

Параметры

pCookie

Указатель на структуру XHR_COOKIE , которая указывает файл cookie и свойства файла cookie, связанного с указанным URL-адресом.

pdwCookieState

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

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

Значение Значение
XHR_COOKIE_STATE_UNKNOWN
0
Зарезервировано.
XHR_COOKIE_STATE_ACCEPT
1
Файл cookie был принят.
XHR_COOKIE_STATE_PROMPT
2
Пользователю предлагается принять или отклонить файл cookie.
XHR_COOKIE_STATE_LEASH
3
Файл cookie принимается только в контексте первой стороны.
XHR_COOKIE_STATE_DOWNGRADE
4
Файл cookie был принят и стал файлом cookie сеанса.
XHR_COOKIE_STATE_REJECT
5
Файл cookie был отклонен.

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

Возвращает S_OK при успешном выполнении.

Комментарии

Метод SetCookie отличается поведением для приложений Магазина Windows и классических приложений Windows.

При использовании в приложении Магазина Windows метод SetCookie по умолчанию задает файл cookie в качестве постоянного файла cookie в приложении Магазина Windows. Если члену dwFlagsXHR_COOKIE установлен флаг XHR_COOKIE_IS_SESSION , файл cookie устанавливается только для текущего сеанса приложения.

При использовании в классическом приложении Windows метод SetCookie по умолчанию задает постоянный файл cookie, который является системным и используется всеми классическими приложениями Windows. Если члену dwFlagsXHR_COOKIE установлен флаг XHR_COOKIE_IS_SESSION , файл cookie устанавливается только для текущего сеанса классического приложения Windows.

Требования

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

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

Метод GetCookie

IXMLHTTPRequest2

Структура XHR_COOKIE

XHR_COOKIE_STATE