LZSeek 함수(lzexpand.h)

파일 포인터를 시작 위치에서 지정된 바이트 수만큼 이동합니다.

구문

LONG LZSeek(
  [in] INT  hFile,
  [in] LONG lOffset,
  [in] INT  iOrigin
);

[in] hFile

파일에 대한 핸들입니다.

[in] lOffset

파일 포인터를 이동할 바이트 수입니다.

[in] iOrigin

포인터의 시작 위치입니다. 이 매개 변수는 다음 값 중 하나여야 합니다.

값	의미
0	파일 포인터 lOffset 바이트를 파일의 시작 부분에서 이동합니다.
1	파일 포인터 lOffset 바이트를 현재 위치에서 이동합니다.
2	파일의 끝에서 파일 포인터 lOffset 바이트를 이동합니다.

함수가 성공하면 반환 값은 파일의 시작 부분에서 새 포인터 위치까지의 오프셋을 지정합니다.

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

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

반환 코드	설명
LZERROR_BADINHANDLE	원본 파일을 식별하는 핸들이 잘못되었습니다. 파일을 읽을 수 없습니다.
LZERROR_BADVALUE	매개 변수 중 하나가 허용되는 값 범위를 벗어났습니다.
LZERROR_GLOBLOCK	LZ 파일 핸들을 잠글 수 없습니다.

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

hFile 매개 변수로 식별된 핸들은 LZInit 또는 LZOpenFile 함수를 호출하여 검색해야 합니다.

Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술을 통해 지원됩니다.

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