다음을 통해 공유


LZRead 함수(lzexpand.h)

파일에서 지정된 바이트 수(최대)를 읽고 버퍼에 복사합니다.

구문

INT LZRead(
  [in]  INT  hFile,
  [out] CHAR *lpBuffer,
  [in]  INT  cbRead
);

매개 변수

[in] hFile

파일에 대한 핸들입니다.

[out] lpBuffer

파일에서 읽은 바이트를 수신하는 버퍼에 대한 포인터입니다. 이 버퍼가 cbRead보다 큰지 확인합니다.

[in] cbRead

읽을 바이트 수입니다.

반환 값

함수가 성공하면 반환 값은 읽은 바이트 수를 지정합니다.

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

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

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

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

설명

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

파일이 압축되면 LZRead 는 파일의 확장된 이미지에서 작동하고 데이터의 바이트를 지정된 버퍼에 복사합니다.

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

LZSeek