KnowledgeBase Archive

An Archive of Early Microsoft KnowledgeBase Articles

View on GitHub

Q30806: MASM 5.10 OS2.DOC: OS/2 Call Summary - File Management

Article: Q30806
Product(s): See article
Version(s): 5.10   | 5.10
Operating System(s): MS-DOS | OS/2
Keyword(s): ENDUSER | | mspl13_masm
Last Modified: 26-MAY-1988

The following information is from the Microsoft Macro Assembler
Version 5.10 OS2.DOC file.

OS/2 Call Summary
File management constant - INCL_DOSFILEMGR

   @DosOpen - Opens a file (creating it if necessary)
   Parameters - FileName:PZ, Handle:PW, ActionTaken:PW, Size:D,
                FileAttribute:W, OpenFlag:W, OpenMode:@, Reserved:D

   @DosClose - Closes a file handle
   Parameters - FileHandle:W

   @DosRead - Reads bytes from a file to a buffer
   Parameters - FileHandle:W, BufferArea:PB, BufferLength:W, ByteRead:PW

   @DosWrite - Writes bytes synchronously from a buffer to a file
   Parameters - FileHandle:W, BufferAddress:PB, BufferLength:W,
                BytesWritten:PW

   @DosDelete - Deletes a file
   Parameters - FileName:PZ, Reserved:D

   @DosDupHandle - Returns a new duplicate file handle for an open file
   Parameters - OldFileHandle:W, NewFileHandle:PW

   @DosQFHandState - Gets the state of the specified file
   Parameters - FileHandle:W, FileHandleState:PW

   @DosSetFHandState - Sets the state of a file
   Parameters - FileHandle:W, FileHandleState:W

   @DosQHandType - Determines whether a handle references a file or a device
   Parameters - FileHandle:W, HandType:PW, FlagWord:PW

   @DosReadAsync - Reads bytes from a file to a buffer asynchronously
   Parameters - FileHandle:W, RamSemaphore:PD, ReturnCode:PW, BufferArea:PB,
                BufferLength:W, BytesRead:PW

   @DosWriteAsync - Writes bytes asynchronously from a buffer to a file
   Parameters - FileHandle:W, RamSemaphore:PD, ReturnCode:PW,
                BufferAddress:PB, BufferLength:W, BytesWritten:PW

   @DosFindFirst - Finds the first directory entry matching a file
                   specification
   Parameters - FileName:PZ, DirHandle:PW, Attribute:W, ResultBuf:PS
                ResultBufLen:W, SearchCount:PW, Reserved:D
   Structure - FILEFINDBUF

   @DosFindNext - Finds the next directory entry matching a file specificatio
   Parameters - DirHandle:W, ResultBuf:PS, ResultBufLen:W, SerachCount:PW
   Structure - FILEFINDBUF

   @DosFindClose - Closes a directory search handle
   Parameters - DirHandle:W

   @DosNewSize - Changes the size of a file
   Parameters - FileHandle:W, Size:D

   @DosBufReset - Flushes a file buffer and updates directory information
   Parameters - FileHandle:W

   @DosChgFilePtr - Moves the read/write pointer according to a specified
                    method
   Parameters - FileHandle:W, Distance:D, MoveType:W, NewPointer:PD

   @DosFileLocks - Locks or unlocks a range in an open file
   Parameters - FileHandle:W, UnlockRange:PD, LockRange:PD

   @DosMove - Moves (or renames) a specified file
   Parameters - OldFilename:PZ, NewFileName:PZ, Reserved:D

   @DosMkdir - Creates a directory
   Parameters - DirName:PZ, Reserved:D

   @DosRmdir - Removes a subdirectory from a disk
   Parameters - DirName:PZ, Reserved:D

   @DosSelectDisk - Selects a specified drive as the new default drive
   Parameters - DriveNumber:W

   @DosQCurDisk - Returns the current drive
   Parameters - DriveNumber:PW, LogicalDriveMap:PD

   @DosChdir - Changes to a specified directory
   Parameters - DirName:PZ, Reserved:D

   @DosQCurDir - Retrieves the full path of the current directory
   Parameters - DriveNumber:W, DirPath:PB, DirPathLen:PW

   @DosQFSInfo - Retrieves information from a file system device
   Parameters - DriveNumber:W, FSInfoLevel:W, FSInfoBuf:PB, FSInfoBufSize:W
   Structure - For GDInfoLevel 1, point FSInfoBuf to FSALLOCATE

   @DosSetFSInfo - Sets information for a file system device
   Parameters - DriveNumber:W, FSInfoLevel:W, FSInfoBuf:PB, FSInfoBufSize:W

   @DosQVerify - Returns the value of the verify flag
   Parameters - VerifySetting:PW

   @DosSetVerify - Sets the verify flag
   Parameters - VerifySetting:W

   @DosSetMaxFH - Defines the maximum number of file handles
   Parameters - NumberHandles:W

   @DosQFileInfo - Returns information about a file
   Parameters - FileHandle:W, FileInfoLevel:W, FileInfoBuf:PB,
                FileInfoBufSize:B
   Structure - At FileInfoLevel 1, can point FileInfoBuf to FILESTATUS

   @DosSetFileInfo - Specifies information for a file
   Parameters - FileHandle:W, FileInfoLevel:W, FileInfoBuf:PB,
                FileInfoBufSize:W
   Structure - At FileInfoLevel 1, can point FileInfoBuf to FILESTATUS

   @DosQFileMode - Retrieves the mode (attribute) of a file
   Parameters - FileName:PZ, Attribute:PW, Reserved:D

   @DosSetFileMode - Changes the mode (attribute) of a file
   Parameters - Filename:PZ, Attribute:W, Reserved:D

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.