InternetGetCookieExA 함수(wininet.h)

아티클
08/27/2023

InternetGetCookieEx 함수는 지정된 URL과 연결된 쿠키에 저장된 데이터를 검색합니다. InternetGetCookie와 달리 InternetGetCookieEx를 사용하여 검색된 데이터를 단일 쿠키 이름으로 제한하거나 신뢰할 수 없는 사이트 또는 타사 쿠키와 연결된 정책을 통해 제한할 수 있습니다.

구문

BOOL InternetGetCookieExA(
  [in]                LPCSTR  lpszUrl,
  [in]                LPCSTR  lpszCookieName,
  [in, out, optional] LPSTR   lpszCookieData,
  [in, out]           LPDWORD lpdwSize,
  [in]                DWORD   dwFlags,
  [in]                LPVOID  lpReserved
);

매개 변수

[in] lpszUrl

검색할 쿠키가 연결된 URL을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수는 NULL 일 수 없거나 InternetGetCookieEx 가 실패하고 ERROR_INVALID_PARAMETER 오류가 반환됩니다.

[in] lpszCookieName

검색할 쿠키의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이 이름은 대/소문자를 구분합니다.

[in, out, optional] lpszCookieData

쿠키 데이터를 받을 버퍼에 대한 포인터입니다.

[in, out] lpdwSize

DWORD 변수에 대한 포인터입니다.

항목에서 변수는 pchCookieData 매개 변수가 가리키는 버퍼의 크기(TCHAR)를 포함해야 합니다.

종료 시 함수가 성공하면 이 변수에는 버퍼에 복사된 쿠키 데이터의 TCHAR 수가 포함됩니다. NULL이 lpszCookieData 매개 변수로 전달되었거나 ERROR_INSUFFICIENT_BUFFER 오류로 인해 함수가 실패하는 경우 변수에는 쿠키 데이터를 수신하는 데 필요한 버퍼 크기(BYTE)가 포함됩니다.

이 매개 변수는 NULL 일 수 없거나 InternetGetCookieEx 가 실패하고 ERROR_INVALID_PARAMETER 오류가 반환됩니다.

[in] dwFlags

함수가 쿠키 데이터를 검색하는 방법을 제어하는 플래그입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
INTERNET_COOKIE_HTTPONLY	"HTTPOnly"로 표시된 쿠키를 검색할 수 있습니다. 스크립팅 가능한 인터페이스를 노출하는 경우 보안에 영향을 주므로 이 플래그를 사용하지 마세요. 제공하는 확장성 메커니즘을 통해 쿠키를 타사 코드에 노출하지 않도록 보장할 수 있는 경우에만 이 플래그를 사용해야 합니다. 버전: 인터넷 Explorer 8.0 이상이 필요합니다.
INTERNET_COOKIE_THIRD_PARTY	정책이 지정된 URL에 대한 모든 쿠키를 명시적으로 검색하도록 허용하는 경우 타사 쿠키만 검색합니다.
INTERNET_FLAG_RESTRICTED_ZONE	지정된 URL이 신뢰할 수 없는 경우 허용되는 쿠키만 검색합니다. 즉, URLZONE_UNTRUSTED 영역에 속한 경우 입니다.

값

의미

INTERNET_COOKIE_HTTPONLY

"HTTPOnly"로 표시된 쿠키를 검색할 수 있습니다.

스크립팅 가능한 인터페이스를 노출하는 경우 보안에 영향을 주므로 이 플래그를 사용하지 마세요. 제공하는 확장성 메커니즘을 통해 쿠키를 타사 코드에 노출하지 않도록 보장할 수 있는 경우에만 이 플래그를 사용해야 합니다.

버전: 인터넷 Explorer 8.0 이상이 필요합니다.

INTERNET_COOKIE_THIRD_PARTY

정책이 지정된 URL에 대한 모든 쿠키를 명시적으로 검색하도록 허용하는 경우 타사 쿠키만 검색합니다.

INTERNET_FLAG_RESTRICTED_ZONE

지정된 URL이 신뢰할 수 없는 경우 허용되는 쿠키만 검색합니다. 즉, URLZONE_UNTRUSTED 영역에 속한 경우 입니다.

[in] lpReserved

다음에 사용하도록 예약됩니다. NULL로 설정합니다.

반환 값

함수가 성공하면 함수는 TRUE를 반환합니다.

함수가 실패하면 FALSE를 반환합니다. 특정 오류 값을 얻으려면 GetLastError를 호출합니다.

NULL이 lpszCookieData에 전달되면 호출이 성공하고 함수가 ERROR_INSUFFICIENT_BUFFER 설정되지 않습니다.

다음 오류 코드는 이 함수에서 설정할 수 있습니다.

반환 코드	설명
ERROR_INSUFFICIENT_BUFFER	검색된 쿠키 데이터가 pcchCookieData 매개 변수가 가리키는 버퍼 크기보다 크거나 해당 매개 변수가 NULL인 경우 반환됩니다.
ERROR_INVALID_PARAMETER	pchURL 또는 pcchCookieData 매개 변수가 NULL인 경우 반환됩니다.
ERROR_NO_MORE_ITEMS	지정된 쿠키 데이터를 검색할 수 없는 경우 반환됩니다.

설명

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

참고

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

요구 사항

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