DosSetFilePtr - Parameters

hFile (HFILE) - input

The handle returned by a previous DosOpen function.

ib (LONG) - input

The signed distance (offset) to move, in bytes.

In the Raw File System, this offset must be a multiple of the sector size, which is 512.

method (ULONG) - input

The method of moving.

Specifies a location in the file from where the ib to move the read/write pointer starts. The values and their meanings are described in the following list:

• FILE_BEGIN Move the pointer from the beginning of the file.

• FILE_CURRENT
  Move the pointer from the current location of the read/write pointer.

• FILE_END
  Move the pointer from the end of the file. Use this method to determine a file's size.

• FILE_SECTOR
  Indicates that the value specified for ib is in sectors rather than bytes. This permits access to disks up to 1 TB (terabyte) in size. This flag must be ORed with either FILE_BEGIN, FILE_CURRENT, or FILE_END and is only valid when using the raw file system.

ibActual (PULONG) - output

Address of the new pointer location.

ulrc (APIRET) - returns

Return Code.

DosSetFilePtr returns one of the following values:

• NO_ERROR 1
  ERROR_INVALID_FUNCTION
  6
  ERROR_INVALID_HANDLE
  25
  ERROR_SEEK
  130
  ERROR_DIRECT_ACCESS_HANDLE
  131
  ERROR_NEGATIVE_SEEK
  132
  ERROR_SEEK_ON_DEVICE
  For a full list of error codes, see Errors.

---

[Back: DosSetFilePtr Return Value - ulrc]
[Next: DosSetFilePtr - Remarks]