CreateUrlCacheEntryA 함수(wininet.h)

  • 아티클

지정된 URL 및 파일 이름 확장명을 기반으로 캐시 항목을 저장하기 위한 로컬 파일 이름을 만듭니다.

구문

BOOL CreateUrlCacheEntryA(
  [in]  LPCSTR lpszUrlName,
  [in]  DWORD  dwExpectedFileSize,
  [in]  LPCSTR lpszFileExtension,
  [out] LPSTR  lpszFileName,
  [in]  DWORD  dwReserved
);

매개 변수

[in] lpszUrlName

URL 이름을 포함하는 문자열 값에 대한 포인터입니다. 문자열에는 값이 포함되어야 합니다. 빈 문자열 로 인해 CreateUrlCacheEntry 가 실패합니다. 또한 문자열에는 이스케이프 문자가 포함되어서는 안됩니다.

[in] dwExpectedFileSize

원본 엔터티에 해당하는 데이터를 TCHAR에 저장하는 데 필요한 파일의 예상 크기입니다. 예상 크기를 알 수 없는 경우 이 값을 0으로 설정합니다.

[in] lpszFileExtension

로컬 스토리지에 있는 파일의 확장명을 포함하는 문자열 값에 대한 포인터입니다.

[out] lpszFileName

파일 이름을 받는 버퍼에 대한 포인터입니다. 버퍼는 생성된 파일의 경로를 저장할 수 있을 만큼 커야 합니다(길이가 MAX_PATH 문자 이상).

[in] dwReserved

이 매개 변수는 예약되어 있으며 0이어야 합니다.

반환 값

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

함수가 실패하면 FALSE를 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

CreateUrlCacheEntry가 호출된 후 애플리케이션은 로컬 스토리지의 파일에 직접 쓸 수 있습니다. 파일이 완전히 수신되면 호출자는 CommitUrlCacheEntry 를 호출하여 캐시에 항목을 커밋해야 합니다.

WinINet은 시스템 코드 페이지에 따라 유니코드 매개 변수를 디코딩하려고 시도합니다. 애플리케이션은 유니코드 매개 변수가 시스템 코드 페이지에 대해 제대로 인코딩되었는지 확인해야 합니다. 애플리케이션은 다음 코드 예제와 같이 InternetSetOption 을 사용하여 시스템 코드 페이지를 설정할 수 있습니다.

DWORD CP_SHIFT_JIS = 932;  // ANSI/OEM  Japanese, Shift-JIS
InternetSetOption( hRequest, 
                   INTERNET_OPTION_CODEPAGE,
                   &CP_SHIFT_JIS, 
                   sizeof(DWORD) );

유니코드 매개 변수가 시스템 코드 페이지에 제대로 인코딩되지 않은 경우 WinINet은 UTF8 디코딩을 시도합니다.

캐시에서 항목을 검색할 때 캐시에 항목을 배치하는 데 사용된 시스템 코드 페이지가 사용자의 현재 시스템 코드 페이지와 일치해야 합니다. IE6 이하에서 실행되는 애플리케이션의 경우 시스템 코드 페이지에 대한 디코딩이 실패하면 WinINet은 UTF8 디코딩을 시도합니다.

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

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

참고

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

요구 사항

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

추가 정보

캐싱

CommitUrlCacheEntry

WinINet 함수