[Windows/WinAPI] SetFilePointer

DWORD WINAPI SetFilePointer(
  _In_         HANDLE hFile,                                   -----①
  _In_         LONG lDistanceToMove,                           -----②
  _Inout_opt_  PLONG lpDistanceToMoveHigh,                     -----③
  _In_         DWORD dwMoveMethod                              -----④
);

함수 설명 :    

파일 포인터를 원하는 위치로 이동시킬때 사용한다. 성공시 새로운 DWORD형인 파일 포인터 값이 리턴되며 실패시에는 INVALID_SET_FILE_POINTER값을 반환한다. 파일 포인터가 마이너스값이 되더라도 실패하게 된다.

① hFile :

파일의 핸들값을 인자로 준다.

② lDistanceToMove :

파일의 포인터를 옮길 위치값을 전해준다. 이때 lpDistanceToMoveHigh에서 값을 준다면 NULL을 인자로 주어야 한다.

③ lpDistanceToMoveHigh :

파일의 포인터를 옮길 위치값을 전해준다. 언제 ②과 구분되는지는 잘 모르겠으나 파일이 클때는 여기에다 위치값을 주어야 한단다.

④ dwMoveMethod :

파일 포인터의 이동 시작 위치를 정해준다. 값으론 다음 3개중 한개이다.

Value	Meaning
FILE_BEGIN(0)	파일의 선두를 시작점으로 잡는다.
FILE_CURRENT(1)	현재의 파일 포인터를 시작점으로 잡는다.
FILE_END(2)	파일 끝점을 이동 개시점으로