LZRead 함수(lzexpand.h)

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

구문

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

[in] hFile

파일에 대한 핸들입니다.

[out] lpBuffer

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

[in] cbRead

읽을 바이트 수입니다.

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

함수가 실패하면 반환 값은 LZERROR_* 코드입니다. 이러한 코드에는 0보다 작은 값이 있습니다. LZRead는 SetLastError 또는 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에서 이 함수는 다음 기술을 통해 지원됩니다.

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