InternetGetCookieEx2 함수(wininet.h)
지정된 URL과 연결된 하나 이상의 쿠키를 검색합니다.
구문
DWORD InternetGetCookieEx2(
PCWSTR pcwszUrl,
PCWSTR pcwszCookieName,
DWORD dwFlags,
INTERNET_COOKIE2 **ppCookies,
PDWORD pdwCookieCount
);
매개 변수
pcwszUrl
쿠키를 검색할 URL입니다.
pcwszCookieName
검색할 쿠키의 이름입니다. NULL일 수 있습니다.
dwFlags
검색할 쿠키의 플래그입니다. 다음 플래그를 사용할 수 있습니다.
| 값 | 의미 |
|---|---|
| INTERNET_COOKIE_THIRD_PARTY | 쿠키를 타사로 검색하여 자사 전용 쿠키를 제외합니다. |
| INTERNET_COOKIE_NON_SCRIPT | 이 쿼리가 JavaScript를 통해 트리거되지 않았으므로 HTTP 전용 쿠키를 검색할 수 있음을 나타냅니다. |
| INTERNET_COOKIE_SAME_SITE_LEVEL_CROSS_SITE | SameSite 속성이 설정된 쿠키를 제외하고 사이트 간 컨텍스트에서처럼 쿠키를 검색합니다. |
| INTERNET_FLAG_RESTRICTED_ZONE | 지정된 URL이 신뢰할 수 없는 경우 허용되는 쿠키만 검색합니다. 즉, URLZONE_UNTRUSTED 영역에 속한 경우 입니다. |
ppCookies
INTERNET_COOKIE2 구조체의 배열을 수신하는 포인터입니다. 반환된 배열은 InternetFreeCookies에서 해제해야 합니다.
pdwCookieCount
배열의 구조체 수를 수신하는 DWORD에 대한 포인터입니다.
반환 값
성공하면 ERROR_SUCCESS 반환하거나 실패 시 시스템 오류 코드를 반환합니다.
설명
참고
WinINet은 서버 구현을 지원하지 않습니다. 또한 서비스에서 사용하면 안 됩니다. 서버 구현 또는 서비스의 경우 WinHTTP(Microsoft Windows HTTP 서비스)를 사용합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8.1 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | R2 Windows Server 2012 [데스크톱 앱만 해당] |
| 머리글 | wininet.h |
| 라이브러리 | Wininet.lib |
| DLL | Wininet.dll |