Allows an application to test whether APPEND has been installed. If APPEND is resident, returns the APPEND version, state, and the path used to search for data files.
Call with:
AH = B7H
AL = subfunction
00H = Get Installed State
02H = Get Append Version (4.0)
04H = Get Append Path Pointer (4.0)
06H = Get Append Function State (4.0)
07H = Set Append Function State (4.0)
11H = Set Return Found Name State (4.0, see Note)
BX = APPEND state (if AL = 07H)
Bit(s) Significance (if set)
0 APPEND enabled
1—12 Reserved (0)
13 /PATH switch active
14 /E switch active
15 /X switch active
Returns:
If function successful
Carry flag = clear
and, if called with AL = 00H
AL = APPEND installed status
00H if not installed, ok to install
01H if not installed, not ok to install
FFH if installed
or, if called with AL = 02H (MS-DOS 4.0)
AX = FFFFH if MS-DOS 4.0 APPEND
or, if called with AL = 04H (MS-DOS 4.0)
ES:DI = segment:offset of active APPEND path
or, if called with AL = 06H (MS-DOS 4.0)
BX = APPEND state (see above)
If function unsuccessful
Carry flag = set
AX = error code
Note:
If the Return Found Name State is set with Subfunction 11H, the fully qualified filename is returned to the next application to call Int 21H Function 3DH, 43H, or 6CH. The name is placed at the same address as the ASCIIZ parameter string for the Int 21H function, so the application must be sure to provide a buffer of adequate size. The Return Found Name State is reset after APPEND processes one Int 21H function call.