FindFirstUrlCacheEntryExA 함수(wininet.h)
인터넷 캐시의 필터링된 열거형을 시작합니다.
통사론
HANDLE FindFirstUrlCacheEntryExA(
[in] LPCSTR lpszUrlSearchPattern,
[in] DWORD dwFlags,
[in] DWORD dwFilter,
[in] GROUPID GroupId,
[out] LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
[in, out] LPDWORD lpcbCacheEntryInfo,
[out] LPVOID lpGroupAttributes,
[in, out] LPDWORD lpcbGroupAttributes,
[in] LPVOID lpReserved
);
매개 변수
[in] lpszUrlSearchPattern
검색할 원본 이름 패턴이 포함된 문자열에 대한 포인터입니다. 이 매개 변수는 "cookie:", "visited:" 또는 NULL로만 설정할 수 있습니다. 이 매개 변수를 "cookie:"로 설정하여 쿠키를 열거하거나 "visited:"를 설정하여 캐시의 URL 기록 항목을 열거합니다. 이 매개 변수가 NULL이면 findFirstUrlCacheEntryEx
[in] dwFlags
열거형을 제어합니다. 현재 구현된 플래그는 없습니다. 이 매개 변수는 0으로 설정해야 합니다.
[in] dwFilter
캐시 항목의 형식과 해당 속성을 나타내는 비트 마스크입니다. 캐시 항목 유형에는 기록 항목(URLHISTORY_CACHE_ENTRY), 쿠키 항목(COOKIE_CACHE_ENTRY) 및 일반 캐시된 콘텐츠(NORMAL_CACHE_ENTRY)가 포함됩니다.
이 매개 변수는 다음 속성 플래그 중 0개 이상일 수 있으며 아래에 나열된 캐시 형식 플래그일 수 있습니다.
| 값 | 의미 |
|---|---|
|
쿠키 캐시 항목입니다. |
|
외부에서 편집된 캐시 항목 파일입니다. 이 캐시 항목 유형은 청소에서 제외됩니다. |
|
일반 캐시 항목; 를 삭제하여 새 항목의 공간을 복구할 수 있습니다. |
|
부분 응답 캐시 항목입니다. |
|
고정 캐시 항목; 은 청소에서 제외합니다. |
|
현재 구현되지 않았습니다. |
|
현재 구현되지 않았습니다. |
|
방문한 링크 캐시 항목입니다. |
[in] GroupId
열거할 캐시 그룹의 ID입니다. 그룹화되지 않은 모든 항목을 열거하려면 이 매개 변수를 0으로 설정합니다.
[out] lpFirstCacheEntryInfo
캐시 항목 정보를 받을 INTERNET_CACHE_ENTRY_INFO 구조체에 대한 포인터입니다.
[in, out] lpcbCacheEntryInfo
lpFirstCacheEntryInfo 매개 변수에서 참조하는 구조체의 크기를 바이트 단위로 나타내는 변수에 대한 포인터입니다.
[out] lpGroupAttributes
이 매개 변수는 예약되어 있으며 NULL이어야 합니다.
[in, out] lpcbGroupAttributes
이 매개 변수는 예약되어 있으며 NULL이어야 합니다.
[in] lpReserved
이 매개 변수는 예약되어 있으며 NULL이어야 합니다.
반환 값
성공하면 유효한 핸들을 반환하고, 그렇지 않으면 NULL을 반환합니다. 특정 오류 정보를 얻으려면 GetLastError호출합니다. 함수가 일치하는 파일을 찾지 못하면 GetLastError
발언
FindFirstUrlCacheEntryEx 반환된 핸들은 FindNextUrlCacheEntryEx대한 모든 후속 호출에 사용됩니다. 열거형이 끝나면 애플리케이션에서 findCloseUrlCache
WinINet API의 다른 모든 측면과 마찬가지로 이 함수는 DllMain 내에서 또는 전역 개체의 생성자 및 소멸자 내에서 안전하게 호출할 수 없습니다.
메모
wininet.h 헤더는 FINDFirstUrlCacheEntryEx를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | wininet.h |
| 라이브러리 | 위니넷 lib |
| DLL | Wininet.dll |
참고 항목
winINet Functions