RUN Function Return of 0 Means Success, Not "Out of Memory"

ID Number: Q84838

1.00

WINDOWS

docerr

Summary:

Contrary to what is stated on page 536 of the "Microsoft Test for

Windows User's Guide" version 1.0 manual, the TestBasic RUN function

returns 0 to indicate success, and returns other values less then 33

to indicate errors. The return codes of the RUN function are identical

to those used for the Windows API call WinExec, except for a return

code of 0. A return code of 0 from the Microsoft Test RUN function

actually indicates success, whereas a return code of 0 indicates an

"Out of memory" error when returned from the Windows API call WinExec.

Below is a list of the possible error numbers returned by the RUN

function.

This information applies to Microsoft Test version 1.0 for Windows.

More Information:

For a complete list of corrections for the "Microsoft Test for Windows

User's Guide" version 1.0 manual, query in the Microsoft Knowledge

Base for the following words:

Test and User's and Guide and docerr

The following is a list of possible TestBasic RUN function return

codes and their meaning:

Value Meaning

----- -------

0 Success

2 File not found

3 Path not found

5 Attempt to dynamically link to a task

6 Library requires separate data segments for each task

10 Incorrect Windows version

11 Invalid .EXE file (non-Windows .EXE or error in .EXE image)

12 OS/2 application

13 MS-DOS 4.0 application

14 Unknown .EXE type

15 Attempt in protected (standard or 386 enhanced) mode to

load an .EXE created for an earlier version of Windows

16 Attempt to load a second instance of an .EXE containing

multiple, writeable data segments

17 Attempt in large-frame EMS mode to load a second instance

of an application that links to certain nonshareable DLLs

already in use

18 Attempt in real mode to load an application marked for protected

mode only

Additional reference words: 1.00