RetrieveUrlCacheEntryFileA 함수(wininet.h)
지정된 URL과 연결된 캐시 항목 파일을 잠급 수 있습니다.
통사론
BOOL RetrieveUrlCacheEntryFileA(
[in] LPCSTR lpszUrlName,
[out] LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
[in, out] LPDWORD lpcbCacheEntryInfo,
[in] DWORD dwReserved
);
매개 변수
[in] lpszUrlName
캐시 항목과 연결된 리소스의 URL을 포함하는 문자열에 대한 포인터입니다. 고유한 이름이어야 합니다. 이름 문자열에는 이스케이프 문자가 포함되어서는 안 됩니다.
[out] lpCacheEntryInfo
캐시 항목 정보 버퍼에 대한 포인터입니다. 버퍼가 충분하지 않으면 이 함수는 ERROR_INSUFFICIENT_BUFFER 반환하고 lpdwCacheEntryInfoBufferSize 필요한 바이트 수로 설정합니다.
[in, out] lpcbCacheEntryInfo
lpCacheEntryInfo 버퍼의 크기를 바이트 단위로 지정하는 부호 없는 긴 정수 변수에 대한 포인터입니다. 함수가 반환되면 변수에는 사용된 실제 버퍼의 크기(바이트)나 캐시 입력 파일을 검색하는 데 필요한 바이트 수가 포함됩니다. 호출자는 이 매개 변수의 반환 값을 확인해야 합니다. 반환 크기가 전달된 크기보다 작거나 같으면 모든 관련 데이터가 반환됩니다.
[in] dwReserved
이 매개 변수는 예약되어 있으며 0이어야 합니다.
반환 값
성공하면
| 반환 코드 | 묘사 |
|---|---|
|
원본 이름으로 지정된 캐시 항목을 캐시 스토리지에서 찾을 수 없습니다. |
|
lpdwCacheEntryInfoBufferSize 지정된 lpCacheEntryInfo 버퍼의 크기만으로는 모든 정보를 포함하기에 충분하지 않습니다. lpdwCacheEntryInfoBufferSize 반환되는 값은 모든 정보를 가져오는 데 필요한 버퍼 크기를 나타냅니다. |
발언
RetrieveUrlCacheEntryFile URL 구문 분석을 수행하지 않으므로 리소스가 캐시된 경우에도 앵커(#)가 포함된 URL을 캐시에서 찾을 수 없습니다. 예를 들어 URL http://adatum.com/example.htm#sample 전달된 경우 http://adatum.com/example.htm 캐시에 있더라도 함수는 ERROR_FILE_NOT_FOUND 반환합니다.
파일이 검색될 때 호출자에 대해 잠겨 있습니다. 호출자가 파일을 완료한 후 호출자가 파일의 잠금을 해제해야 합니다. 캐시 관리자는 특정 간격 후에 파일의 잠금을 자동으로 해제합니다. 파일이 잠겨 있는 동안 캐시 관리자는 캐시에서 파일을 제거하지 않습니다. 이 함수는 캐시의 내부 구현에 따라 효율적으로 수행되거나 수행되지 않을 수 있다는 점에 유의해야 합니다. 예를 들어 URL 데이터가 다른 URL에 대한 데이터가 포함된 압축된 파일에 저장되는 경우 캐시는 캐시에서 유지 관리하는 임시 디렉터리의 파일에 데이터 복사본을 만듭니다. 캐시는 결국 복사본을 삭제합니다. 이 함수는 애플리케이션을 시작하는 데 파일 이름이 필요한 경우에만 사용하는 것이 좋습니다. RetrieveUrlCacheEntryStream 및 관련 스트림 함수는 대부분의 경우 사용해야 합니다.
WinINet API의 다른 모든 측면과 마찬가지로 이 함수는 DllMain 내에서 또는 전역 개체의 생성자 및 소멸자 내에서 안전하게 호출할 수 없습니다.
메모
wininet.h 헤더는 RETRIEVEUrlCacheEntryFile을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | wininet.h |
| 라이브러리 | 위니넷 lib |
| DLL | Wininet.dll |
참고 항목
winINet Functions