Help Compiler Messages
When compiling or decompiling a Help project, the compiler returns messages to report typical events, and problems that were encountered.
When a project is compiled using Help Workshop or HxComp.exe, messages are displayed on-screen during the process, and a log file is created after the job is complete.
Error Message Types
When the compiler is used programmatically, the in-process COM server returns messages, which the client can obtain through the IHxCompError interface.
There are four types of messages: informational, warning, error, and fatal error. Compiler messages are designated by an HXC* prefix, followed by a unique four-digit numeric code and the message string. The following table describes the ID naming convention for all compiler messages except informational messages, which are self-explanatory and therefore not documented.
Note
In compiler messages that contain line number and character position values, the compiler will return a value of "0" when the actual value cannot be determined by the parser.
Prefix |
Type |
|---|---|
HXCxxxx |
HxComp server warning or error |
Fatal Error HXCxxxx |
HxComp server fatal error |
ERROR HXCxxxx |
HxComp.exe error |
WARNING HXCxxxx |
HxComp.exe warning |
The range for numeric message identifiers is as follows:
Range |
Message type |
|---|---|
1001-2000 |
Command-line only |
2000-2050 |
Internal fatal |
5001-6000 |
Internal error |
2051-3000 |
HxCompServer fatal |
3001-4000 |
HxCompServer error |
6001-7000 |
HxCompServer warning |
4001-4030 |
MSXML parser error |
7001-7030 |
MSXML parser warning |
4031-4060 |
HxV Parser error |
7031-7060 |
HxV Parser warning |
4061-4090 |
Attribute validator error |
7061-7090 |
Attribute validator warning |
4091-4120 |
Attribute validator/XML DOM error |
7091-7120 |
Attribute validator/XML DOM warning |
4121-4150 |
HxC parser error |
7121-7150 |
HxC parser warning |
4151-4180 |
CUrlList error |
7151-7180 |
CUrlList warning |
The following table lists all of the possible warning and error messages that the compiler can return.
Prefix |
String |
|---|---|
Unable to open file %1. File not decompiled. |
|
Cannot open file %1. Ignored. |
|
Unable to write to %1. %2. |
|
HXC6004: The value of the FileVersion attribute in is not x.x.x.x (where 0 <= x <= 65535). Ignored. |
The value of the FileVersion attribute in %1 is not x.x.x.x (where 0 <= x <= 65535). Ignored. |
HXC6005: The Title attribute of the <HelpCollection>tag contains more than 2000 characters. Ignored: |
The Title attribute of the <HelpCollection>tag contains more than 2000 characters. Ignored: %1 |
HXC6006: The value of the Name attribute for an <MSHelp:Attr> element exceeds 256 characters. |
The value of the Name attribute for an <MSHelp:Attr> element exceeds 256 characters. |
HXC6007: The value of the Value attribute for an <MSHelp:Attr> element exceeds 256 characters. |
The value of the Value attribute for an <MSHelp:Attr> element exceeds 256 characters. |
HXC6008: The Name attribute for an <MSHelp:Attr> tag has no value. |
The Name attribute for an <MSHelp:Attr> tag has no value. |
HXC6009: The Value attribute for an <MSHelp:Attr> tag has no value. |
The Value attribute for an <MSHelp:Attr> tag has no value. |
HXC6010: The HTML <title> element is missing or invalid in file . |
The HTML <title> element is missing or invalid in file %1. |
The virtual topic %1 was used before being declared. |
|
No file matching the wildcard string %1 was found. |
|
No sample files were added from %1. %2 ignored. |
|
HXC6014: No index (.HxK) files are specified in the collection definition (.HxC) file. |
No index (.HxK) files are specified in the collection definition (.HxC) file. |
The CopyDestDir attribute in for a <sample> tag in the sample definition (.HxE) file has no value. |
|
HXC6016: // or \\\\ in a file specification is not supported. Ignored. |
// or \\\\ in a file specification is not supported. Ignored. |
%1 in a file specification is not supported. Ignored. |
|
HXC6018: A parent node in the TOC is missing the Title attribute for the <HelpTOCNode> element. |
A parent node in the TOC is missing the Title attribute for the <HelpTOCNode> element. |
No URL assigned to node. Assigning ~~Empty~~.htm. |
|
The value of the Title attribute for a <HelpTOCNode> element in the .HxT file exceeds 2000 characters. Ignored: %1 |
|
HXC6021 |
Invalid TOC type. |
The Name attribute for an <ItemMoniker> element in a collection definition (.HxC) file has no value. |
|
The ProgId attribute for an <ItemMoniker> element in a collection definition (.HxC) file has no value. |
|
The value of the InitData attribute for an <ItemMoniker> element in an .HxC file exceeds 49 characters. Truncated: %1 |
|
Ignoring hidden file: %1 |
|
The value of the Name attribute (%1) for the <HelpIndex> element is duplicated in more than one index (.HxK) file. Ignored the duplicate in %2. |
|
The value of the Name attribute (%1) for the <ItemMoniker> element is duplicated in more than one collection definition (.HxC) file. Ignored the duplicate in %2. |
|
No index defined in <MsHelp:Keyword>. |
|
No term defined in <MsHelp:Keyword>. |
|
Unable to open stop word file %1. |
|
HXC6033: The Url attribute of the <HelpTOCNode> element has no value. Ignored. |
The Url attribute of the <HelpTOCNode> element has no value. Ignored. |
HXC6034: Stop word file name is too long. Stop word file ignored. |
Stop word file name is too long. Stop word file ignored. |
HXC6035: The sample load string is too long; the string has been truncated to characters. |
The sample load string is too long; the string has been truncated to %1 characters. |
HXC6036: The copy destination directory is too long; the string has been truncated to characters. |
The copy destination directory is too long; the string has been truncated to %1 characters. |
HXC6037: TOC node is indented more than 256 levels. Ignored. |
TOC node is indented more than 256 levels. Ignored. |
HXC6038: Level of keyword is greater than 16 in the index. Ignored. |
Level of keyword %1 is greater than 16 in the %2 index. Ignored. |
The NodeType attribute for a <HelpTOCNode> element in an .HxT file that is set to the value TOC cannot have child nodes. Ignored. |
|
Unknown MSHelp tag %1. |
|
Encountered undefined attribute %1 for MSHelp tag %2. |
|
<MSHelp> tag %1 requires attribute %2. |
|
VTopic%1 must start with a letter or underscore, contain letter, digit, period, hyphen, underscore only. Ignored. |
|
VTopic contains no characters. Ignored. |
|
VTopic %1 contains more than 64 characters. Ignored. |
|
HXC6046: KeywordList contains more than 2000 characters. Ignored: |
KeywordList contains more than 2000 characters, Ignored: %1 |
HXC6047: Charset is invalid in . Ignored and set to DefaultCharset 1. |
Charset %1 is invalid in %2. Ignored and set to DefaultCharset 1. |
HXC6048: No term was defined for the <Keyword> tag in . Ignored. |
No term was defined for the <Keyword> tag in %1. Ignored. |
%1 contains a keyword (including Ref, and probably after entity resolution) of length more than 503. Ignored: %2 |
|
A project file extension was specified in the .HxE, but no matching file was compiled. Ignoring the extension. |
|
HXC6051: Ignoring the keyword term with the string length of 0: |
Ignoring the keyword term with string of length 0: %1 |
The value of the Name attribute in the <ItemMoniker> tag contains more than %1 characters. Ignored. |
|
The value of the ProgId attribute in the <ItemMoniker> tag contains more than %1 characters. Ignored. |
|
The value of the InitData attribute in the <ItemMoniker> tag contains more than %1 characters. Ignored. |
|
LangId %1 is invalid in %2. Using default 1033. |
|
HXC6056: IconFile in is not in the project root directory and was not saved. |
IconFile %1 is not in project root directory and was not saved. |
A file specification, %1, begins with '$' or '#'. Files and directories in the project root starting with those characters are unsupported. The files will not be added. |
|
Icon %1 is invalid in %2. Ignored. |
|
Compressed sample %1 compiled from outside project root. Decompiled to $OutsideRoot\$Samples. |
|
File list name %1 is too long. |
|
HXC5001 |
An internal error has occurred; contact Microsoft Help product support for assistance. |
HXC5002 |
An internal error has occurred; contact Microsoft Help product support for assistance. |
HXC5003 |
An internal error has occurred; contact Microsoft Help product support for assistance. |
HXC5004 |
An internal error has occurred; contact Microsoft Help product support for assistance. |
HXC5005 |
An internal error has occurred; contact Microsoft Help product support for assistance. |
HXC5006 |
An internal error has occurred on subfile %1; contact Microsoft Help product support for assistance. |
HXC5007: Initialization of the XML parser failed. Reinstall Microsoft Help Workshop. |
Initialization of the XML parser failed. Reinstall Microsoft Help Workshop. |
HXC3001: Unable to create a temporary file for the attribute index . |
Unable to create a temporary file for the attribute index, %1. |
Unable to complete index compilation. Likely causes are insufficient memory or hard drive space. |
|
HXC3003 |
Unable to open project file %1. |
Unable to open file %1 to be decompiled. |
|
The number of errors is greater than or equal to 50% of the number of topics. Deleting all output files. |
|
HXC3006: The following file name contains more than 2048 characters: |
The following file name contains more than 2048 characters: %1 |
HXC3007: The value of the Name attribute for an <MSHelp:Attr>tag contains more than 256 characters. |
The value of the Name attribute for an <MSHelp:Attr> tag contains more than 256 characters. |
HXC3008: The name of an end tag for an HTML or XML element exceeds 256 characters. |
The name of an end tag for an HTML or XML element exceeds 256 characters. |
Illegal tag. |
|
HXC3010: The name of an HTML element exceeds 256 characters. |
The name of an HTML element exceeds 256 characters. |
HXC3011: The value of the <title> tag for an HTML topic exceeds 2000 characters. |
The value of the <title> tag for an HTML topic exceeds 2000 characters. |
Unexpected character in tag name. |
|
Unexpected characters in the end tag. |
|
Cannot add a keyword (%1) to an automatically generated (sorted) index (%2). Memory allocation failure or malformed link text. |
|
HXC3019: The .HxT file has the same base name as another TOC file and will be ignored. |
The .HxT file %1 has the same base name as another TOC file and will be ignored. |
No .HxE file specified. |
|
No target specified for keyword %1. |
|
HXC3022 |
No cross-reference Target specified for Keyword %1. |
Failed to open file %1. |
|
Out of memory. |
|
Failed to read file %1. |
|
HXC3026: Errors were found compiling the sample. not compiled. |
Errors were found compiling the sample. %1 not compiled. |
In the .HxE file, no path to the distribution directory was specified with a DistribDir attribute. |
|
HXC3028: Sample staging directory not specified. Sample will not be built. |
Sample staging directory not specified. Sample %1 will not be built. |
The sum of the TOCTitle attribute, RLTitle attribute, and <TITLE> tag for a topic file exceeds 2000 characters. |
|
An index name is specified in the Index attribute of an <MSHelp:Keyword> tag, but there is no corresponding index in the project. |
|
HXC3031: A group of keywords for a single Help link or KTable exceeds 4,096 bytes. |
A group of keywords for a single Help link or KTable exceeds 4,096 bytes. |
Out of memory. |
|
No files found at %1 for sample %2. |
|
Duplicate SampleId detected: %1. Ignoring sample. |
|
Error compressing files: %1 |
|
Zero-size file ignored: %1 |
|
HXC3037: The destination directory exceeds maximum length. not compiled. |
The destination directory exceeds maximum length. %1 not compiled. |
HXC3040: The sample staging directory path exceeds maximum length. not compiled. |
The sample staging directory path exceeds %1 characters. Sample %2 not compiled. |
The sample destination directory path exceeds %1 characters. Check the DistribDir and SampleStagingDir attribute values. Sample %2 not compiled. |
|
HXC3042: The SFL name exceeds characters. Sample not compiled. |
The SFL name exceeds %1 characters. Sample %2 not compiled. |
The compressed SFL destination exceeds %1 characters. Check the SFLName and SampleId attribute values. Sample %2 not compiled. |
|
HXC3044: The SFL contains illegal characters: . Sample not compiled. |
The SFL contains illegal characters: %1. Sample %2 not compiled. |
The uncompressed SFL file could not be created. The full destination path may be too long or there may be a destination media problem. |
|
HXC3046: The XML file contains no DOCTYPE declaration or the root element is not . |
The XML file %1 contains no DOCTYPE declaration or the root element is not %2. |
HXC3048: The value of the SourceDir attribute contains more than characters. Sample not compiled. |
The value of the SourceDir attribute contains more than %1 characters. Sample %2 not compiled. |
Sample is missing an ID. Unable to compile sample. |
|
HXC3050: The value of the CopyDestDir attribute must be a relative path. Sample not compiled. |
The value of the CopyDestDir attribute must be a relative path. Sample %1 not compiled. |
HXC3051: The value of the CopyDestDir attribute contains illegal characters. Sample not compiled. |
The value of the CopyDestDir attribute contains illegal characters. Sample %1 not compiled. |
HXC3052: The value of the SampleId attribute contains illegal characters: |
The value of the SampleId attribute contains illegal characters: %1 |
The destination directory could not be created. The DistribDir or the SampleStagingDir attributes many contain invalid characters. |
|
HXC3054: The stop word list, , is too small. It must contain at least one word. |
The stop word list, %1, is too small. It must contain at least one word. |
HXC3055: There was an error in creating a full-text index for the content. |
There was an error in creating a full-text index for the content. |
The length of the sample source directory and file name is too long for sample file %1 in directory %2. Sample not compiled. |
|
The length of the sample destination directory and file name is too long for sample file %1 in directory %2. Sample not compiled. |
|
HXC3058: The name of the decompile destination directory is too long. not decompiled. |
The name of the decompile destination directory is too long. %1 not compiled. |
HXC3059: A link in the TOC to a topic in another .HxS file is too long. |
A link in the TOC to a topic in another .HxS file is too long. |
The sample destination directory %1 is not a subdirectory of the sample staging directory. Sample %2 not compiled. |
|
HXC3061: The sample include directory is too long. Sample not compiled. |
The sample include directory %1 is too long. Sample %2 not compiled. |
HXC3062: The sample exclude directory is too long. Sample not compiled. |
The sample exclude directory %1 is too long. Sample %2 not compiled. |
No .HxV file specified. |
|
HXC4032: Failed to initialize the XML parser for the .HxV file. |
Failed to initialize the XML parser for the .HxV file. |
Out of memory. |
|
Out of memory. |
|
Unexpected element in .HxA file; expecting <%1>. |
|
HXC4091 |
An internal error has occurred; contact Microsoft Help technical support for assistance. |
HXC4092: The element <> in the .HxA file requires a Name attribute. |
The element <%1> in the .HxA file requires a Name attribute. |
An internal error has occurred; contact Microsoft Help technical support for assistance. |
|
HXC4094: No AttVal elements were specified for AttName element with Name: . |
No AttVal elements were specified for AttName element with Name: %1. |
HXC4121: There is no value specified for the File attribute in the IncludeFile tag. |
There is no value specified for the File attribute in the IncludeFile tag. |
Out of memory. |
|
Out of memory. |
|
Failed to initialize XML parser. |
|
Out of memory. |
|
An internal error has occurred; contact Microsoft Help product support for assistance. |
|
HXC2002 |
An internal error has occurred; contact Microsoft Help product support for assistance. |
HXC2003 |
An internal error has occurred; contact Microsoft Help product support for assistance. |
An internal error has occurred; contact Microsoft Help product support for assistance. |
|
HXC2008 - HXC2009: Failed to initialize HTML Help file system. Reinstall Microsoft Help Workshop. |
Failed to initialize HTML Help file system. Reinstall Microsoft Help Workshop. |
HXC2009 |
Failed to initialize HTML Help file system. Reinstall Microsoft Help Workshop. |
HXC2010: Unable to write the full-text index to the file system. |
Unable to write the full-text index to the file system. |
Ran out of memory building the full-text index. |
|
Unable to read file %1, which might be corrupt. |
|
HXC2052: Unable to update the version stamp TopicCount information. The .HxS file has been deleted. |
Unable to update the version stamp TopicCount information. The .HxS file has been deleted. |
HXC2053: Unable to create file . The file might already exist and be in use. |
Unable to create file %1. The file might already exist and be in use. |
File %1 is currently in use or cannot be written to. |
|
The environment variable TMP must point to a location that can provide at least 2MB of temporary disk space. |
|
Parse of the .HxC file failed. |
|
HXC2057: Unable to create the file . The file may already exist and be in use. |
Unable to create the file %1. The file may already exist and be in use. |
Invalid file: %1 |
|
HXC2059: The value Hxn is not implemented for the CompileResult attribute. |
The value Hxn is not implemented for the CompileResult attribute. |
Out of memory. |
|
The output file must have an .HxS extension. |
|
The project file must have an .HxC extension. |
|
The specified project directory %1 is not valid. |
|
Unable to initialize the full-text index engine. |
|
The value of a File attribute within an element contains more than 2000 characters. Ignored. |
|
XML syntax error: %1 |
|
File not found: %1 |
|
HXC7061: The Name attribute of the AttName tag is empty. Ignored. |
The Name attribute of the AttVal tag is empty. Ignored. |
HXC7062: The Name attribute of the AttVal tag is empty. Ignored. |
The Name attribute of the AttName tag is empty. Ignored. |
HXC7063: The value of the UIString attribute of the AttVal tag is too long and will be ignored: |
The value of the UIString attribute of the AttVal tag is too long and will be ignored: %1 |
HXC7064: The AttName element with name contains no valid AttVal elements. |
The AttrName element with name %1 contains no valid AttVal element. |
DTDVersion is not %1 in %2. |
|
Tag %1 specified an empty URL in %2. Ignored. |
|
HXC7067: Tag specified an empty LocalFile attribute value in . Ignored. |
Tag %1 specified an empty LocalFile attribute value in %2. Ignored. |
HXC7068: Extension of the LocalFile attribute, , is neither .htm nor .html in . Ignored. |
Extension of the LocalFile attribute, %1, is neither .htm nor .html in %2. Ignored. |
HXC7100: Attribute Name is longer than 255 characters in . Ignored. |
Attribute Name %1 is longer than 255 characters in %2. Ignored. |
Attribute Name is empty in %1. Ignored. |
|
HXC7102: Attribute Value is longer than 255 characters in . Ignored. |
Attribute Value %1 is longer than 255 characters in %2. Ignored. |
Attribute Name is empty in %1. Ignored. |
|
HXC7104: The Index attribute () in the <Keyword> tag is longer than 49 characters in . Ignored. |
The Index attribute (%1) in the <Keyword> tag is longer than 49 characters in %2. Ignored. |
HXC7105: The Index attribute in the <Keyword> tag is empty in . Ignored. |
The Index attribute in the <Keyword> tag is empty in %1. Ignored. |
HXC7106: The Term attribute () in the <Keyword> tag is longer than 2000 characters in . Ignored. |
The Term attribute (%1) in the <Keyword> tag is longer than 2000 characters in %2. Ignored. |
HXC7107: The Term attribute in the <Keyword> tag is empty in . Ignored. |
The Term attribute in the <Keyword> tag is empty in %1. Ignored. |
HXC7091: The value of the AttName attribute in the .HxA file is too long and will be ignored: |
The value of the AttName attribute in the .HxA file is too long and will be ignored: %1 |
HXC7092: The value of the UIString attribute of the AttName tag is too long and will be ignored: |
The value of the UIString attribute of the AttName tag is too long and will be ignored: %1 |
HXC7093: The value of the AttVal attribute in the .HxA file is too long and will be ignored: |
The value of the AttVal attribute in the .HxA file is too long and will be ignored: %1 |
HXC7094: The attribute of the AttName tag is defined multiple times; using the last definition. |
The %1 attribute of the AttName tag is defined multiple times; using the last definition. |
URL %1 is not under the project root. Ignored. |
|
File %1 is not under the project root. Ignored. |
|
Option %1 requires a value. |
|
Option %1 does not take a value. |
|
Option %1 can only be specified once. |
|
Unrecognized parameter %1. |
|
Fatal Error HXC1005: The decompile options -u and -d cannot be used if the -p option is specified. |
The decompile options -u and -d cannot be used if the -p option is specified. |
Fatal Error HXC1006: The compile options -r and -o cannot be used if the -u option is specified. |
The compile options -r and -o cannot be used if the -u option is specified. |
Fatal Error HXC1007: The directory , specified as the project root, does not exist. |
The directory %1, specified as the project root, does not exist. |
Fatal Error HXC1008: The directory , specified as the decompile directory, does not exist. |
The directory %1, specified as the decompile directory, does not exist. |
Fatal Error HXC1009: The log file cannot be saved to directory . |
The log file cannot be saved to directory %1. |
Fatal Error HXC1010: Directory cannot be used as the decompile directory. |
Directory %1 cannot be used as the decompile directory. |
Unable to locate the project file %1. |
|
Unable to read the project file %1. |
|
Unable to write to the output directory %1. |
|
Fatal Error HXC1014: A dash must be followed by an option letter. |
A dash must be followed by an option letter. |
Fatal Error HXC1015: The -n and -l options cannot both be specified. |
The -n and -l options cannot both be specified. |
Fatal Error HXC1016: The directory , specified for the log file, does not exist. |
The directory %1, specified for the log file, does not exist. |
Fatal Error HXC1017: No .HxC file has been specified. Use the -p option. |
No .HxC file has been specified. Use the -p option. |
The output file name is too long. |
|
The .HxC file name is too long. |
|
The project root name is too long. |
|
Fatal Error HXC1021: Log file cannot have an .Hx* extension. |
Log file cannot have an .Hx* extension. |
HXC1022: The compiler server could not be initialized. Reinstall the Microsoft Help 2.0 compiler. |
The compiler server could not be initialized. Reinstall the Microsoft Help 2.0 compiler. |
Fatal Error HXC1023: The decompile directory name is too long. |
The decompile directory name is too long. |
The decompile file name is too long. |
|
The output directory %1 does not exist. |
|
Unable to open the log file %1. |
|
Fatal Error HXC1027 |
The log file name is too long. |