To run H2INC, type H2INC at the command-line prompt, followed by the options desired and the names of the .H files you want to convert:
H2INC [[options]]file.H ...
You can specify more than one file.H. File names are separated by a space. The contents of each file.H are translated into a single file in the current directory with the name file.INC. The original file.H is not altered.
The following lists describe the available options. You can specify more than one option. Note that the options are case sensitive except for /HELP.
H2INC recognizes /? to display a summary of H2INC syntax, and /HELP to invoke QuickHelp for H2INC. If QuickHelp is not available, H2INC displays a short list of H2INC options. This option is not case sensitive.
H2INC recognizes but ignores C 6.0 options that aren't specified in the following two lists.
This first list describes the options that directly affect the H2INC output:
| Option | Action | |
| /C | Passes comments in the .H file to the .INC file. | |
| /Fa [[filename]] | Specifies that the output file contain only equivalent MASM statements. This is the default. If specified, the filename overrides the default, keeping the base name of the C header files and adding the .INC extension. | |
| /Fc [[filename]] | Specifies that the output file contain equivalent MASM statements plus original C statements converted to comment lines. | |
| /Mn | Assumes the .MODEL directive is not specified for the MASM source or the generated .INC files. Instructs H2INC to declare explicitly the distances for all pointers and functions. | |
| /Ni | Suppresses the expansion of nested include files. | |
| /Zu | Makes all structure and union tag names unique. |
This second list describes the options that indirectly affect the H2INC output:
| Option | Action | |
| /AT | Specifies tiny memory model (.COM). | |
| /AS | Specifies small memory model, the default. | |
| /AC | Specifies compact memory model. | |
| /AM | Specifies medium memory model. | |
| /AL | Specifies large memory model. | |
| /AH | Specifies huge memory model. | |
| /D[[const[[=value]] ]] | Defines a constant or macro. | |
| /G0 | Enables 8086/8088 instructions (default). | |
| /G1 | Enables 80186/80188 instructions. | |
| /G2 | Enables 80286 instructions. | |
| /G3 | Enables 80386 instructions. Changes the default word size to DWORD. | |
| /G4 | Enables 80486 instructions. Changes the default word size to DWORD. | |
| /Gc | Specifies Pascal as the default calling convention. | |
| /Gd | Specifies C as the default calling convention for functions (default). | |
| /Gr | Specifies the _fastcall calling convention for functions. Generates a warning since H2INC does not translate _fastcall functions and prototypes. | |
| /Ht | Enables generation of text equates. By default, text items are not translated. | |
| /Ipaths | Searches named paths for include files before searching the paths in the INCLUDE environment variable. Paths are separated with a semicolon (;). | |
| /J | Changes default character type from signed char to unsigned char. | |
| /nologo | Suppresses display of the sign-on banner. | |
| Option | Action | |
| /Tc [[filename]] | Enables the processing of files whose name does not end in .H. | |
| /uident | “Undefines” one of the predefined identifiers. (See Section 16.3.1.) | |
| /U | “Undefines” all predefined identifiers. (See Section 16.3.1.) | |
| /w | Suppresses compiler warning messages; same as /W0. | |
| /W0 | Suppresses all warning messages. | |
| /W1 | Displays level 1 warning messages (default). | |
| /W2 | Displays level 1 and level 2 warning messages. | |
| /W3 | Displays level 1, 2, and 3 warning messages. | |
| /W4 | Displays all warning messages. | |
| /X | Excludes search for include files in the standard places. | |
| /Za | Disables language extensions (allows ANSI standard only). | |
| /Zc | Causes functions declared as _pascal to be case insensitive. | |
| /Ze | Enables language extensions (default). | |
| /Zn string | Adds string to all names generated by H2INC. Used to eliminate name conflicts with other H2INC-generated include files. | |
| /Zp{1|2|4} | Packs structure on a 1-, 2-, or 4-byte boundary, following C packing rules. Default is /Zp2. |