InternetSetCookieA 함수(wininet.h)

아티클
03/13/2024

지정된 URL과 연결된 쿠키를 만듭니다.

구문

BOOL InternetSetCookieA(
  [in] LPCSTR lpszUrl,
  [in] LPCSTR lpszCookieName,
  [in] LPCSTR lpszCookieData
);

매개 변수

[in] lpszUrl

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

[in] lpszCookieName

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

[in] lpszCookieData

URL과 연결할 실제 데이터에 대한 포인터입니다.

반환 값

성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다. 특정 오류 메시지를 얻으려면 GetLastError를 호출합니다.

설명

만료 날짜 없이 InternetSetCookie 에서 만든 쿠키는 메모리에 저장되며 쿠키를 만든 동일한 프로세스에서만 사용할 수 있습니다. 만료 날짜를 포함하는 쿠키는 windows\cookies 디렉터리에 저장됩니다.

새 쿠키를 만들면 사용자의 개인 정보 설정에 따라 사용자에게 이 사이트의 쿠키를 허용하거나 허용하지 않을지 묻는 대화 상자가 화면에 표시될 수 있습니다.

주의InternetSetCookie는 인터넷 Explorer "모든 쿠키 차단"이 설정된 경우에도 무조건 쿠키를 만듭니다. "모든 쿠키 차단" 설정이 활성 상태인 동안 이러한 쿠키가 이후에 서버로 다시 전송되지 않더라도 이 동작은 개인 정보 침해로 볼 수 있습니다. 애플리케이션은 사용자의 개인 정보 설정을 올바르게 적용하기 위해 InternetSetCookieEx 를 사용해야 합니다.

더 많은 쿠키 내부는 를 참조하세요 http://blogs.msdn.com/ieinternals/archive/2009/08/20/WinINET-IE-Cookie-Internals-FAQ.aspx.

WinINet API의 다른 모든 측면과 마찬가지로 이 함수는 DllMain 내에서 또는 전역 개체의 생성자 및 소멸자에서 안전하게 호출할 수 없습니다.

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

참고

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wininet.h
라이브러리	Wininet.lib
DLL	Wininet.dll