DosQAppType
Bindings: C, MASM
This call returns the application type of an executable file.
DosQAppType (ExecutableFileName, AppType)
ExecutableFileName (PSZ) - input
Address of the ASCIIZ string containing the filename of the executable
file where the flags are returned.
If the string appears to be a fully qualified path (contains a " : "
in the second position and/or contains a " \ "), only the indicated
drive:directory is searched. If the string is not a fully qualified
path, the current directory is searched. If the filename is not found
in the current directory, each drive:directory specification in the
PATH defined in the current program's environment is searched for this
file. Note that any extension (.xxx) is acceptable for the executable
filename. If no extension is specified, a default extension of ".exe"
is used. AppType is a word that contains flags denoting the
application type, as determined by reading the executable file header
specified by ExecutableFileName. Note that the call sequence passes a
pointer to a location in application memory to return the application
type flags.
AppType (PUSHORT) - output
Address of the application type defined as follows:
Bit Description
15-6 Reserved.
5 Set to 1 if executable file is PC DOS format. Bits 0, 1, 2,
3, and 4 are set to zero.
4 Set to 1 if executable file is a dynamic link module. Bits
0, 1, 2, 3, and 5 are set to 0.
3 Set to 1 if executable has been "bound" (BIND command) as a
Family API application. Bits 0, 1 and 2 still apply.
2-0 Bits 2, 1 and 0 indicate application type, as specified in
the header of the executable file.
Value Definition
000 Application type is not specified in executable header.
001 Application is NOTWINDOWCOMPAT
010 Application type is WINDOWCOMPAT
011 Application type is WINDOWAPI
rc (USHORT) - return
Return code descriptions are:
0 NO_ERROR
2 ERROR_FILE_NOT_FOUND
3 ERROR_PATH_NOT_FOUND
4 ERROR_TOO_MANY_OPEN_FILES
11 ERROR_BAD_FORMAT
15 ERROR_INVALID_DRIVE
32 ERROR_SHARING_VIOLATION
108 ERROR_DRIVE_LOCKED
110 ERROR_OPEN_FAILED
191 ERROR_INVALID_EXE_SIGNATURE
192 ERROR_EXE_MARKED_INVALID
Remarks
This function is used by the Presentation Manager shell to determine the
application type being executed. The application type is specified at
link time in the module definition file.
Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs