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

Статья
08/25/2023

Задает файл 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 при успешном выполнении.

При использовании в приложении Магазина 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

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

Share via