다음을 통해 공유


LZCopy 함수(lzexpand.h)

원본 파일을 대상 파일에 복사합니다. 원본 파일이 Lempel-Ziv 알고리즘에 의해 압축된 경우 이 함수는 압축 해제된 대상 파일을 만듭니다. 원본 파일이 압축되지 않으면 이 함수는 원래 파일을 복제합니다.

구문

LONG LZCopy(
  [in] INT hfSource,
  [in] INT hfDest
);

매개 변수

[in] hfSource

원본 파일에 대한 핸들입니다.

[in] hfDest

대상 파일에 대한 핸들입니다.

반환 값

함수가 성공하면 반환 값은 대상 파일의 크기(바이트)를 지정합니다.

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

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

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

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

설명

LZInit 또는 LZOpenFile 함수를 호출하여 원본 및 대상 파일을 식별하는 핸들을 검색해야 합니다.

함수가 성공하면 hfDest 매개 변수로 식별된 파일은 항상 압축되지 않습니다.

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

참고 항목

파일 압축 및 압축 해제

파일 관리 함수

LZInit

LZOpenFile