다음을 통해 공유


LZInit 함수(lzexpand.h)

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

구문

INT LZInit(
  [in] INT hfSource
);

매개 변수

[in] hfSource

파일에 대한 핸들입니다.

반환 값

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

함수가 실패하면 반환 값은 LZERROR_* 코드입니다. 이러한 코드에는 0보다 작은 값이 있습니다. LZInitSetLastError 또는 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

참고 항목

파일 압축 및 압축 해제

파일 관리 함수