Table of Contents

This is part of Family API which allow to create dual-os version of program runs under OS/2 and DOS

Note: This is legacy API call. It is recommended to use 32-bit equivalent

2021/09/17 04:47 · prokushev · 0 Comments
2021/08/20 03:18 · prokushev · 0 Comments

DosDelete

This call removes a directory entry associated with a file name.

Syntax

DosDelete (FileName, Reserved)

Parameters

Return Code

rc (USHORT) - return

Return code descriptions are:

Remarks

Global file name characters are not permitted.

A file whose read-only attribute is set cannot be deleted. To change the setting of the read-only bit, call DosSetFileMode.

Bindings

C Binding

  #define INCL_DOSFILEMGR
 
  USHORT  rc = DosDelete(FileName, Reserved);
 
  PSZ              FileName;      /* File name path */
  ULONG            0;             /* Reserved (must be zero) */
 
  USHORT           rc;            /* return code */

Example

This example deletes a file in the current directory named test.dat.

  #define INCL_DOSFILEMGR
 
  #define FILE_DELETE "test.dat"
  #define RESERVED 0L
 
  USHORT rc;
 
   rc = DosDelete(FILE_DELETE,    /* File path name */
                  RESERVED);      /* Reserved (must be zero) */

MASM Binding

  EXTRN  DosDelete:FAR
  INCL_DOSFILEMGR     EQU 1
 
  PUSH@  ASCIIZ  FileName      ;Filename path name string
  PUSH   DWORD   0             ;Reserved (must be zero)
  CALL   DosDelete

Returns WORD

Note

Text based on http://www.edm2.com/index.php/DosDelete_(FAPI)