Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄CFile►                                       ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  virtual LONG Seek( LONG lOff, UINT nFrom )
  throw( CFileException );
 
  Parameter   Description
 
  <lOff>      Number of bytes to move the pointer.
 
  <nFrom>     Pointer movement mode. Must be one of the following:
 
              Value            Meaning
 
              CFile::begin     Move the file pointer <lOff> bytes forward
                               from the beginning of the file.
 
              CFile::current   Move the file pointer <lOff> bytes from the
                               current position in the file.
 
              CFile::end       Move the file pointer backward <lOff> bytes
                               from the end of the file.
 
  Remarks
 
  Repositions the pointer in a previously opened file. The Seek function
  permits random access to a file's contents by moving the pointer a
  specified amount, absolutely or relatively. No data is actually read
  during the seek.
 
  When a file is opened, the file pointer is positioned at offset 0, the
  beginning of the file.
 
  Return Value
 
  If the requested position is legal, Seek returns the new byte offset
  from the beginning of the file. Otherwise, the return value is
  undefined, and a CFileException object is thrown.
 
  Example
 
  extern CFile cfile;
  LONG lOffset = 1000, lActual;
  lActual = cfile.Seek( lOffset, CFile::begin );
 
 
 
                                     -♦-