dos12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
DosQAppType (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSSESMGR
 
USHORT DosQAppType(pszPrgName, pusType)
PSZ pszPrgName;     /* pointer to executable-file name   */
PUSHORT pusType;    /* pointer to application-type flags */
 
The DosQAppType function retrieves the application type of an executable
file. The application type is specified at link time in the
module-definition file.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
pszPrgName  Points to the null-terminated string that contains the name of
            the executable file for which the flags are to be returned. If
            the string appears to be a fully qualified path (that is, it
            contains a colon in the second position and/or contains a
            backslash), the file will be searched for in the indicated
            directory on the indicated drive. If neither of these conditions
            is true and the file is not in the current directory, each drive
            and directory specification in the path defined in the current
            program's environment will be searched. The default extension
            for an executable file is .exe, although any extension is
            acceptable.
 
pusType     Points to a word containing flags that specify the application
            type, as determined from the header of the executable file
            specified by the pszPrgName parameter. Upon return, the variable
            pointed to by the pusType parameter will have one or more of the
            following flags set:
 
            Value           Meaning
            ────────────────────────────────────────────────────────────────
            BOUND           Application has been "bound" and can run either
                            in protected mode or with MS-DOS (either the
                            compatibility box or MS-DOS, version 3.x or
                            later).
 
            DOSFORMAT       Application will run only with MS-DOS.
 
            DYNAMICLINK     Application is a dynamic-link module.
 
            NOTSPECIFIED    Application type is not specified in executable
                            header.
 
            NOTWINDOCOMPAT  Application will run only in a full screen
                            session.
 
            WINDOWAPI       Application runs as a Presentation Manager
                            window.
 
            WINDOWCOMPAT    Application will run in a VIO window.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is one
of the following values:
 
     ERROR_BAD_FORMAT
     ERROR_DRIVE_LOCKED
     ERROR_EXE_MARKED_INVALID
     ERROR_FILE_NOT_FOUND
     ERROR_INVALID_EXE_SIGNATURE
     ERROR_TOO_MANY_OPEN_FILES
 
See Also
 
PrfQueryProgramCategory