| Previous | Next |
| QPLIST_E_DUPLICATE | QPLIST_E_BYREF_USED_WITHOUT_PTRTYPE |
QPLIST_E_VECTORBYREF_USED_ALONE
DBTYPE_VECTOR or DBTYPE_BYREF appears without a base type
QPLIST_E_VECTORBYREF_USED_ALONE is HRESULT 0x8004165D. Windows documents it as “DBTYPE_VECTOR or DBTYPE_BYREF used alone.”
Where the failure belongs
This result belongs to legacy Windows property-list parsing and is returned while validating the composed OLE DB type expression. The exact condition is: a modifier is serialized as the entire type because the base DBTYPE is empty, dropped or combined incorrectly.
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.
Likely causes
Rejection of the property list does not yet distinguish file access, tokenization, type composition, GUID syntax or duplicate-definition failure.
Telemetry that matters
- Record raw type expression before releasing the relevant objects.
- Associate numeric DBTYPE flags with the exact UTC timestamp and correlation identifier.
- Compare failing and known-good values for expected base type under the same provider or handler version.
- Record the source and normalization path of modifier intent, not only its display form.
- Record property-list file identity and hash before releasing the relevant objects.
Hash the complete file if it is sensitive while retaining encoding, line, column, raw token class and the surrounding property declaration.
Verification workflow
- Capture raw type expression and numeric DBTYPE flags at the call boundary that returns this result.
- Confirm the operation reached validating the composed OLE DB type expression with the intended expected base type.
- recover the actual base type from property schema and inspect numeric flag composition.
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.
Safe remediation
Combine the modifier with the correct base type or remove an unintended modifier. Delay cannot repair a deterministic file, token or type-grammar defect; retry only after the property list or its readable source changes.
Avoid the wrong conclusion
It does not prove that every property definition is unusable or that reindexing is required; it identifies a property-list read or grammar boundary.
How nearby codes differ
QPLIST_E_BYREF_USED_WITHOUT_PTRTYPE has a base type, but that base is not permitted with BYREF.
Developer and administrator guidance
Worked example
A byte-vector property is emitted as DBTYPE_VECTOR without DBTYPE_UI1. Correct flag composition restores the intended type.
Official Microsoft references
Looking for a different code? Search another status or error code.