Previous
Index
Next
INT 2F CU - NETWORK REDIRECTOR - CREATE/TRUNCATE REMOTE FILE AX = 1117h ES:DI -> uninitialized SFT SS = DOS DS SDA first filename pointer -> fully-qualified name of file to open SDA CDS pointer -> current directory structure for drive with file STACK: WORD file creation mode low byte = file attributes (see #01401 at INT 21/AH=3Ch) high byte = 00h normal create, 01h create new file Return: CF set on error AX = DOS error code (see #01680 at INT 21/AH=59h/BX=0000h) CF clear if successful SFT filled (except handle count, which DOS manages itself) STACK unchanged Notes: this function is called by the DOS 3.1+ kernel in MS-DOS, lDOS, and Enhanced DR-DOS the handle count is FFFFh during this call, marking the SFT as "busy". they all unconditionally set the count to 0001h after successful open. MS-DOS v5+ and lDOS will free "busy" SFTs belonging to the active process (matching process ID and machine ID) during process termination if the process isn't self-parented and the termination is not TSR. MS-DOS v4 and Enhanced DR-DOS will free any SFTs belonging to the active process (matching process ID and machine ID) during process termination if the process isn't self-parented and the termination is not TSR. FreeDOS seems to pass the SFT with a handle count of 0000h, and increments it if it is still 0000h after successful open. it doesn't seem to close SFTs like the MS-DOS v5 "busy" SFTs as associated with a process (only closing the handles found in the PHT / Job File Table and SFTs in use for FCBs). SeeAlso: AX=1106h,AX=1116h,AX=1118h,AX=112Eh,INT 21/AH=3Ch,INT 21/AH=60h