| Previous | Next |
| QPLIST_E_UNRECOGNIZED_TYPE | QPLIST_E_EXPECTING_CLOSE_PAREN |
QPLIST_E_EXPECTING_INTEGER
The property-list grammar requires an integer field
QPLIST_E_EXPECTING_INTEGER is HRESULT 0x80041656. Windows documents it as “Expecting integer.”
Contract and failing stage
This result belongs to legacy Windows property-list parsing and is returned while reading a numeric property-specification component or option. The exact condition is: an empty field, symbolic label, localized grouping separator or unsupported notation appears where digits are required.
This value belongs to the legacy property-list parser used to describe indexed properties and their types. Diagnose the external list as structured configuration: preserve line, column, token, type grammar and the property-list version instead of treating the file as arbitrary text. The exact public message comes from the legacy SDK contract; current property-system documentation does not replace the property-list grammar that rejected this file.
Conditions that produce it
Rejection of the property list does not yet distinguish file access, tokenization, type composition, GUID syntax or duplicate-definition failure.
Evidence to preserve
- Record the source and normalization path of grammar field, not only its display form.
- Record allowed range before releasing the relevant objects.
- Associate surrounding delimiters with the exact UTC timestamp and correlation identifier.
- Compare failing and known-good values for formatter locale under the same provider or handler version.
- Record the source and normalization path of property-list file identity and hash, not only its display form.
Hash the complete file if it is sensitive while retaining encoding, line, column, raw token class and the surrounding property declaration.
Diagnostic sequence
- Capture grammar field and raw numeric token at the call boundary that returns this result.
- Confirm the operation reached reading a numeric property-specification component or option with the intended allowed range.
- identify the grammar owner of the number and preserve the unformatted application value.
Begin with a one-property list accepted by the same parser, then restore the failing declaration token by token while preserving encoding and line endings.
Recovery and retry
Emit an invariant integer in the permitted range; never substitute zero unless zero is semantically valid. Delay cannot repair a deterministic file, token or type-grammar defect; retry only after the property list or its readable source changes.
What the code does not prove
It does not prove that every property definition is unusable or that reindexing is required; it identifies a property-list read or grammar boundary.
Related HRESULT values
QPARSE_E_EXPECTING_INTEGER concerns query text, not property-list configuration.
Developer and administrator guidance
Practical scenario
A formatter emits 1,033 for a property identifier. The comma terminates the token, so invariant numeric formatting is introduced.
Official Microsoft references
Looking for a different code? Search another status or error code.