INTERNET_CACHE_ENTRY_INFOA 구조체(wininet.h)

아티클
03/13/2024

인터넷 캐시의 항목에 대한 정보를 포함합니다.

구문

typedef struct _INTERNET_CACHE_ENTRY_INFOA {
  DWORD    dwStructSize;
  LPSTR    lpszSourceUrlName;
  LPSTR    lpszLocalFileName;
  DWORD    CacheEntryType;
  DWORD    dwUseCount;
  DWORD    dwHitRate;
  DWORD    dwSizeLow;
  DWORD    dwSizeHigh;
  FILETIME LastModifiedTime;
  FILETIME ExpireTime;
  FILETIME LastAccessTime;
  FILETIME LastSyncTime;
  LPSTR    lpHeaderInfo;
  DWORD    dwHeaderInfoSize;
  LPSTR    lpszFileExtension;
  union {
    DWORD dwReserved;
    DWORD dwExemptDelta;
  };
} INTERNET_CACHE_ENTRY_INFOA, *LPINTERNET_CACHE_ENTRY_INFOA;

멤버

dwStructSize

이 구조체의 크기(바이트)입니다. 이 값을 사용하여 캐시 시스템의 버전을 확인할 수 있습니다.

lpszSourceUrlName

URL 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 문자열은 이 구조체의 끝에 있는 메모리 영역을 차지합니다.

lpszLocalFileName

로컬 파일 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 문자열은 이 구조체의 끝에 있는 메모리 영역을 차지합니다.

CacheEntryType

캐시 항목의 유형과 해당 속성을 나타내는 비트 마스크입니다. 캐시 항목 유형에는 기록 항목(URLHISTORY_CACHE_ENTRY), 쿠키 항목(COOKIE_CACHE_ENTRY) 및 일반 캐시된 콘텐츠(NORMAL_CACHE_ENTRY)가 포함됩니다.

이 멤버는 아래 나열된 다음 속성 플래그 및 캐시 형식 플래그 중 0개 이상일 수 있습니다.

값	의미
EDITED_CACHE_ENTRY	외부에서 편집된 캐시 항목 파일입니다. 이 캐시 항목 유형은 청소에서 제외됩니다.
SPARSE_CACHE_ENTRY	부분 응답 캐시 항목입니다.
STICKY_CACHE_ENTRY	dwExemptDelta에서 지정한 시간 동안 청소에서 제외되는 고정 캐시 항목입니다. CommitUrlCacheEntryA 및 CommitUrlCacheEntryW에서 설정한 기본값은 1일입니다.
TRACK_OFFLINE_CACHE_ENTRY	현재 구현되지 않습니다.
TRACK_ONLINE_CACHE_ENTRY	현재 구현되지 않습니다.

다음 목록에는 캐시 형식 플래그가 포함되어 있습니다.

값	의미
COOKIE_CACHE_ENTRY	쿠키 캐시 항목입니다.
NORMAL_CACHE_ENTRY	기본 캐시 항목입니다. 새 항목을 위한 공간을 확보하기 위해 삭제할 수 있습니다.
URLHISTORY_CACHE_ENTRY	방문한 링크 캐시 항목입니다.

dwUseCount

캐시 항목을 사용하는 WinINEet 호출자의 현재 수입니다.

dwHitRate

캐시 항목이 검색된 횟수입니다.

dwSizeLow

파일 크기의 하위 부분( 바이트)입니다.

dwSizeHigh

파일 크기의 상위 부분( 바이트)입니다.

LastModifiedTime

이 URL의 마지막으로 수정된 시간을 그리니치 평균 시간 형식으로 포함하는 FILETIME 구조체입니다.

ExpireTime

이 파일의 만료 시간을 포함하는 FILETIME 구조체(그리니치 평균 시간 형식)입니다.

LastAccessTime

마지막으로 액세스한 시간을 그리니치 평균 시간 형식으로 포함하는 FILETIME 구조체입니다.

LastSyncTime

캐시가 마지막으로 동기화된 시간을 포함하는 FILETIME 구조체입니다.

lpHeaderInfo

헤더 정보를 포함하는 버퍼에 대한 포인터입니다. 버퍼는 이 구조체의 끝에 있는 메모리를 차지합니다.

dwHeaderInfoSize

TCHAR에서 lpHeaderInfo 버퍼의 크기입니다.

lpszFileExtension

데이터를 파일로 검색하는 데 사용되는 파일 이름 확장명을 포함하는 문자열에 대한 포인터입니다. 문자열은 이 구조체의 끝에 있는 메모리 영역을 차지합니다.

dwReserved

dwExemptDelta

마지막으로 액세스한 시간(초)의 예외 시간입니다.

설명

캐시 진입 크기 제한은 없으므로 캐시를 열거해야 하는 애플리케이션은 변수 크기의 버퍼를 할당할 준비가 되어 있어야 합니다. 자세한 내용은 버퍼 사용을 참조하세요.

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

참고

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	wininet.h