System::SetFilePointer

System::SetFilePointer will change the current file position of a file previously opened by System::CreateFile.

public System::SetFilePointer(
   OSHandle FileHandle,
   Integer Position = 0,
   Integer Method = System::FILE_BEGIN
:  Integer Position
);

Parameters

FileHandle From previous call to System::CreateFile.
Position The position that the file wants to be moved to.
Method Any one of:- System::FILE_BEGIN; System::FILE_CURRENT; xor System::FILE_END.
Position resulting position after the method has completed.

Return Values

The error.errorCode value will be set to the underlining windows error message code and the error.errorString will have a detailed description of the error.

Remarks

  • System::SetFilePointer(FileHandle) will move to the begining of the file.
  • System::SetFilePointer(FileHandle,0,System::FILE_CURRENT:currentPosition) will return the current location of the file.
Example Use
variable fileHandle, fileBuffer;
System::CreateFile(L"MyFile.txt",
   System::OPEN_EXISTING|System::READ_ONLY:fileHandle);
System::SetFilePointer(fileHandle,50);
System::ReadFile(fileHandle:fileBuffer);
System::MessageBox(fileBuffer.ToString(),
   L"File Contents of MyFile.txt after 50 bytes");

Requirements

TScript Version: 1.3

Also See

System::CreateFile, System::ReadFile, System::WriteFile
 

Contact Ekky Software

All around the world Ekky Software is contactable seven days of the week by submitting the following details.

Thank you for your time and interest.
Ekky Software Customer Support Team.

Ekky Software Product Range
Ekky Software Homepage Texas Business Software ObjectDatabase++ TScript Ekky Software Homepage Texas Business Software ObjectDatabase++ TScript