Share via

LZInit 함수(lzexpand.h)

  • 아티클

파일 압축을 해제하는 데 필요한 내부 데이터 구조에 사용할 메모리를 할당한 다음, 파일을 만들고 초기화합니다.

구문

INT LZInit(
  [in] INT hfSource
);

매개 변수

[in] hfSource

파일에 대한 핸들입니다.

반환 값

함수가 성공하면 반환 값은 새 LZ 파일 핸들입니다.

함수가 실패하면 반환 값은 LZERROR_* 코드입니다. 이러한 코드에는 0보다 작은 값이 있습니다. LZInit는 SetLastError 또는 SetLastErrorEx를 호출하지 않습니다. 따라서 오류는 스레드의 마지막 오류 코드에 영향을 주지 않습니다.

다음은 LZInit 에서 실패 시 반환할 수 있는 오류 코드 목록입니다.

반환 코드 설명
LZERROR_BADINHANDLE
 원본 파일을 식별하는 핸들이 잘못되었습니다. 파일을 읽을 수 없습니다.
LZERROR_GLOBALLOC
 열려 있는 압축된 파일의 최대 수가 초과되었거나 로컬 메모리를 할당할 수 없습니다.
LZERROR_GLOBLOCK
 LZ 파일 핸들을 잠글 수 없습니다.
LZERROR_UNKNOWNALG
 파일은 인식할 수 없는 압축 알고리즘으로 압축됩니다.
 

이 함수에 대한 확장 오류 정보는 없습니다. GetLastError를 호출하지 마세요.

설명

지정된 시간에 최대 16개 압축 파일을 열 수 있습니다. 마찬가지로, 압축되지 않은 파일은 언제든지 최대 16개까지 열 수 있습니다. 애플리케이션은 파일을 사용하여 작업을 수행할 때 LZInit 에서 반환한 핸들을 닫아야 합니다. 그렇지 않으면 애플리케이션이 실수로 16 파일 제한에 도달할 수 있습니다.

이 함수가 반환하는 핸들은 Lz32.dll 함수와만 호환됩니다. 다른 파일 작업에는 사용하지 않아야 합니다.

Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술을 통해 지원됩니다.

기술 지원됨
SMB(서버 메시지 블록) 3.0 프로토콜 예
SMB 3.0 TFO(투명 장애 조치(failover)) 예
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0 예
CsvFS(클러스터 공유 볼륨 파일 시스템) 예
ReFS(Resilient File System) 예
 

CsvF는 압축된 파일에 대해 리디렉션된 IO를 수행합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 lzexpand.h(Windows.h 포함)
라이브러리 Lz32.lib
DLL Lz32.dll

참고 항목

파일 압축 및 압축 해제

파일 관리 함수