Microsoft KB Archive/43560

= Getting Full EXEC Pathname from Environment Table Using PSP =

Article ID: 43560

Article Last Modified on 11/21/2006

-

APPLIES TO


 * Microsoft QuickBasic 4.0
 * Microsoft QuickBASIC 4.0b
 * Microsoft QuickBasic 4.5 for MS-DOS
 * Microsoft BASIC Compiler 6.0
 * Microsoft BASIC Compiler 6.0b
 * Microsoft BASIC Professional Development System 7.0
 * Microsoft BASIC Professional Development System 7.1

-



This article was previously published under Q43560



SUMMARY
In MS-DOS versions 3.00 and later, the full path of any executing program is stored after the environment variables in the environment segment that is found in the program segment prefix (PSP). This article provides a description of how to extract the EXEC path and gives an example of how to do this with Basic.



MORE INFORMATION
The segment address of the PSP for the currently executing process can be checked with the DOS Interrupt 21 hex, function 62 hex.

The environment segment can be found in the PSP at offset 2C hex. The environment table has an entry for each environment variable of the format =. Each entry is terminated by a null character [CHR$(0)] and the entire table is followed by an additional null character. After the additional null character, there is a 2-byte word count. Immediately after the word count, the full path of the executing program is listed as   : \. and is also terminated by a null character.

For more information about the PSP and the environment table, see &quot;Advanced MS-DOS Programming, 2nd Edition&quot; by Ray Duncan, published by Microsoft Press (1988).

Code Example
The following code example provides a function that will return the full path of the currently executing program in DOS 3.00 and later: 'Compile and link lines: ' BC FULLPATH; ' LINK FULLPATH,,,QB.LIB;   NOTE: QBX.LIB should be used for PDS '                                7.00 or 7.10 '$INCLUDE: 'qb.bi' ' NOTE: QBX.BI should be used for PDS 7.00/7.10 DECLARE FUNCTION FullPath$ CONST EnvOffInPSP = &H2C

PRINT FullPath$

FUNCTION FullPath$ DIM inregs AS RegType, OutRegs AS RegType

inregs.ax = &H6200 'Get PSP CALL INTERRUPT(&H21, inregs, OutRegs)

PSPSeg% = OutRegs.bx EnvironSeg& = 0 OffSet& = 0 tmp$ = &quot;&quot;

DEF SEG = PSPSeg% EnvironSeg& = 256 * PEEK(EnvOffInPSP + 1) + PEEK(EnvOffInPSP)

DEF SEG = EnvironSeg& WHILE (PEEK(OffSet&) <> 0 OR PEEK(OffSet& + 1) <> 0) OffSet& = OffSet& + 1 WEND

'Skip extra bytes between Env Table and Fullpath OffSet& = OffSet& + 4

'Build FullPath$ (until null terminates string) WHILE PEEK(OffSet&) <> 0 tmp$ = tmp$ + CHR$(PEEK(OffSet&)) OffSet& = OffSet& + 1 WEND DEF SEG

FullPath$ = tmp$ END FUNCTION

Additional query words: QuickBas BasicCom

Keywords: KB43560

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.