InternetSetCookieExA 함수(wininet.h)

아티클
08/27/2023

InternetSetCookieEx 함수는 지정된 URL과 연결된 지정된 이름의 쿠키를 만듭니다. 이 함수는 타사 쿠키를 만들 수 있어 InternetSetCookie 함수와 다릅니다.

구문

DWORD InternetSetCookieExA(
  [in] LPCSTR    lpszUrl,
  [in] LPCSTR    lpszCookieName,
  [in] LPCSTR    lpszCookieData,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwReserved
);

매개 변수

[in] lpszUrl

쿠키를 설정해야 하는 URL을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

이 포인터가 NULL이면 InternetSetCookieEx 가 ERROR_INVALID_PARAMETER 오류와 함께 실패합니다.

[in] lpszCookieName

이 쿠키와 연결할 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이 포인터가 NULL이면 쿠키와 연결된 이름이 없습니다.

[in] lpszCookieData

새 쿠키와 연결할 데이터가 포함된 null로 끝나는 문자열에 대한 포인터입니다.

이 포인터가 NULL이면 InternetSetCookieEx 가 ERROR_INVALID_PARAMETER 오류와 함께 실패합니다.

[in] dwFlags

함수가 쿠키 데이터를 검색하는 방법을 제어하는 플래그:

값	의미
INTERNET_COOKIE_EVALUATE_P3P	이 플래그가 설정되고 dwReserved 매개 변수가 NULL이 아닌 경우 dwReserved 매개 변수는 해당 쿠키에 대한 P3P(Platform-for-Privacy-Protection) 헤더를 가리키는 LPCTSTR 로 캐스팅됩니다.
INTERNET_COOKIE_HTTPONLY	"HTTPOnly"로 표시된 쿠키를 검색할 수 있습니다. 스크립팅 가능한 인터페이스를 노출하는 경우 보안에 영향을 주므로 이 플래그를 사용하지 마세요. 스크립팅 가능한 인터페이스를 노출하는 경우 사이트 간 스크립팅 공격에 대한 공격 벡터가 될 수 있습니다. 제공하는 확장성 메커니즘을 통해 타사 코드가 이 플래그를 사용하여 쿠키를 설정하도록 허용하지 않도록 보장할 수 있는 경우에만 이 플래그를 사용해야 합니다. 버전: 인터넷 Explorer 8.0 이상이 필요합니다.
INTERNET_COOKIE_THIRD_PARTY	설정되는 쿠키가 타사 쿠키임을 나타냅니다.
INTERNET_FLAG_RESTRICTED_ZONE	설정되는 쿠키가 신뢰할 수 없는 사이트와 연결되어 있음을 나타냅니다.

[in] dwReserved

NULL이거나 쿠키와 연결할 P3P(Platform-for-Privacy-Protection) 헤더에 대한 포인터를 포함합니다.

반환 값

성공하면 InternetCookieState 열거형의 멤버를 반환하고, 함수가 실패하면 FALSE 를 반환합니다. 실패 시 GetLastError 에 대한 호출이 ERROR_NOT_ENOUGH_MEMORY 반환하는 경우 시스템 메모리가 부족합니다.

설명

참고 WinINet은 서버 구현을 지원하지 않습니다. 또한 서비스에서 사용하지 않아야 합니다. 서버 구현 또는 서비스의 경우 WinHTTP(Microsoft Windows HTTP 서비스)를 사용합니다.

참고

wininet.h 헤더는 INTERNETSetCookieEx를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wininet.h
라이브러리	Wininet.lib
DLL	Wininet.dll