LZCopy 함수(lzexpand.h)
원본 파일을 대상 파일에 복사합니다. 원본 파일이 Lempel-Ziv 알고리즘에 의해 압축된 경우 이 함수는 압축 해제된 대상 파일을 만듭니다. 원본 파일이 압축되지 않으면 이 함수는 원래 파일을 복제합니다.
구문
LONG LZCopy(
[in] INT hfSource,
[in] INT hfDest
);
매개 변수
[in] hfSource
원본 파일에 대한 핸들입니다.
[in] hfDest
대상 파일에 대한 핸들입니다.
반환 값
함수가 성공하면 반환 값은 대상 파일의 크기(바이트)를 지정합니다.
함수가 실패하면 반환 값은 LZERROR_* 코드입니다. 이러한 코드에는 0보다 작은 값이 있습니다. LZCopy는 SetLastError 또는 SetLastErrorEx를 호출하지 않습니다. 따라서 오류는 스레드의 마지막 오류 코드에 영향을 주지 않습니다.
다음은 LZCopy 가 실패 시 반환할 수 있는 오류 코드 목록입니다.
| 반환 코드 | 설명 |
|---|---|
|
원본 파일을 식별하는 핸들이 잘못되었습니다. 파일을 읽을 수 없습니다. |
|
대상 파일을 식별하는 핸들이 잘못되었습니다. 파일을 쓸 수 없습니다. |
|
열려 있는 압축된 파일의 최대 수가 초과되었거나 로컬 메모리를 할당할 수 없습니다. |
|
LZ 파일 핸들을 잠글 수 없습니다. |
|
원본 파일 형식이 잘못되었습니다. |
이 함수에 대한 확장된 오류 정보는 없습니다. 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 |