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.

 ◄Key► ◄Summary►                             ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
  Description:
 
     See ◄Introduction to Byte-Stream Routines►
 
  Parameters on Entry:
 
     file-handle             The file handle returned when the file was
                             opened.
 
     file-offset             The offset in file at which to write. This
                             field is currently limited to a maximum value
                             of x"00FFFFFFFF".
 
     byte-count              The number of bytes to write. This field is
                             currently limited to a maximum value of
                             x"00FFFF".
 
                             Putting a value of zero in this field will
                             cause the file to be truncated or extended to
                             the size specified in the file-offset field.
 
     flags                   This parameter can take the following value:
 
                                 0 for standard write
 
     buffer                  The buffer from which the bytes are written.
                             It is your responsibility to ensure that the
                             buffer is large enough to hold the number of
                             bytes to be written.
 
                             The buffer parameter is allowed to cross a 64K
                             segment boundary.
 
  Parameters on Exit:
 
     None
                                    -♦-