IXMLHTTPRequest2::SetCookie 메서드(msxml6.h)

HTTP 쿠키 jar에서 지정된 URL과 연결된 쿠키를 설정합니다.

구문

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

매개 변수

pCookie

지정된 URL과 연결할 쿠키 및 쿠키의 속성을 지정하는 XHR_COOKIE 구조체에 대한 포인터입니다.

pdwCookieState

호출이 성공적으로 완료된 경우 쿠키 상태를 나타내는 값에 대한 포인터입니다.

이 매개 변수는 Msxml6.h 헤더 파일에 정의된 XHR_COOKIE_STATE 열거형 형식의 값 중 하나일 수 있습니다.

값	의미
XHR_COOKIE_STATE_UNKNOWN 0	예약되어 있습니다.
XHR_COOKIE_STATE_ACCEPT 1	쿠키가 수락되었습니다.
XHR_COOKIE_STATE_PROMPT 2	사용자에게 쿠키를 수락하거나 거부하라는 메시지가 표시됩니다.
XHR_COOKIE_STATE_LEASH 3	쿠키는 자사 컨텍스트에서만 허용됩니다.
XHR_COOKIE_STATE_DOWNGRADE 4	쿠키가 수락되어 세션 쿠키가 되었습니다.
XHR_COOKIE_STATE_REJECT 5	쿠키가 거부되었습니다.

반환 값

성공하면 S_OK를 반환합니다.

설명

SetCookie 메서드는 Windows 스토어 앱 및 Windows 데스크톱 애플리케이션에 대해 서로 다른 동작을 사용합니다.

Windows 스토어 앱에서 사용되는 경우 SetCookie 메서드는 기본적으로 쿠키를 Windows 스토어 앱에서 영구 쿠키로 설정합니다. XHR_COOKIEdwFlags 멤버에 XHR_COOKIE_IS_SESSION 플래그가 설정된 경우 쿠키는 앱의 현재 세션에 대해서만 설정됩니다.

Windows 데스크톱 애플리케이션에서 사용되는 경우 SetCookie 메서드는 기본적으로 시스템 전체이며 모든 Windows 데스크톱 애플리케이션에서 공유하는 영구 쿠키를 설정합니다. XHR_COOKIEdwFlags 멤버에 XHR_COOKIE_IS_SESSION 플래그가 설정된 경우 쿠키는 Windows 데스크톱 애플리케이션의 현재 세션에 대해서만 설정됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱 | UWP 앱],MSXML 6.0 이상
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	msxml6.h

추가 정보

GetCookie 메서드

IXMLHTTPRequest2

XHR_COOKIE 구조체

XHR_COOKIE_STATE