| Previous | Next |
| VFW_E_ALREADY_CANCELLED | VFW_E_CORRUPT_GRAPH_FILE |
TPC_E_RECOGNIZER_NOT_REGISTERED
Meaning and numerical form
TPC_E_RECOGNIZER_NOT_REGISTERED is HRESULT 2147746357 (0x80040235; signed -2147220939). AllStat records its meaning as “TabletPC inking error code. There are no handwriting recognizers registered”. In practical terms, it is returned when handwriting recognition is requested but no applicable recognizer is registered for the selected language or capability.
The severity bit in 0x80040235 is set, so this result is a failure result rather than a success or informational status. Its facility is 4 (FACILITY_ITF) and its low 16-bit code is 565 (0x0235). Those fields classify the value but do not identify the component instance, call, object or input that produced it.
Evidence to collect
A useful diagnostic record for this result includes the native API or interface method, component or CLSID, process and thread IDs, architecture, apartment where relevant, operation correlation ID, elapsed time, input identity, and the first state-changing event before failure. When diagnosing it, preserve IErrorInfo, an inner HRESULT, Win32 status, device event or provider message when available.
- Capture 1 for this HRESULT: enumerated recognizers, language identifiers and capabilities.
- Capture 2 for this HRESULT: recognizer COM registration and package state.
- Capture 3 for this HRESULT: process architecture and user-specific versus machine-wide availability.
Telemetry for this HRESULT should retain types, lengths, hashes, stable opaque identifiers and lifecycle generations while redacting content and credentials. This makes repeated incidents comparable without exposing ink content, packet data, account details or recognizer input.
Where the failure belongs
This result belongs to Tablet PC ink, stylus and recognition. Tablet PC APIs span device enumeration, RealTimeStylus packet queues, ink-object lifetime and recognizer-specific capabilities. The numerical facility does not identify which Tablet PC layer produced the result. The decisive condition is this: handwriting recognition is requested but no applicable recognizer is registered for the selected language or capability. Record the first native producer instead of relying only on a framework exception translated several layers later.
Do not infer from this result alone that reinstalling, rebooting or repeating the whole workflow is appropriate. Because it can cross process and language boundaries, its correction depends on the object identity, lifecycle generation, input and state at the first failing call.
Likely causes
- Possible cause 1 for this HRESULT: the recognizer package is not installed.
- Possible cause 2 for this HRESULT: registration was removed or belongs to another architecture.
- Possible cause 3 for this HRESULT: the requested language has no matching recognizer.
Diagnostic sequence
- Capture it at the first native return and identify the exact object and method.
- Confirm that the observed path matches this condition: handwriting recognition is requested but no applicable recognizer is registered for the selected language or capability.
- compare the live state with the method contract before changing configuration.
- collect the code-specific evidence listed above and preserve any more specific preceding error.
- change one evidence-backed cause at a time, then repeat the smallest operation that can prove the correction.
- Add a regression check that distinguishes it from the related outcomes described below.
Correction and retry boundary
- Corrective action 1 for this HRESULT: install or repair a supported recognizer package.
- Corrective action 2 for this HRESULT: select from recognizers actually enumerated on the host.
- Corrective action 3 for this HRESULT: provide a non-recognition workflow when the capability is optional.
Retry guidance for this HRESULT. Retry after recognizer installation or registration changes; repeating recognition without a recognizer cannot succeed. A retry must avoid this hazard: replay stale strokes, reorder stylus packets or reuse an invalid recognizer context. It must also preserve the evidence needed to locate the original producer of it.
Difference from nearby HRESULTs
TPC_E_INVALID_RIGHTS means a recognizer exists but its information cannot be read under the current user; this HRESULT means no applicable recognizer is registered. Keep these outcomes separate in logs, exception mappings, user messages, dashboards and automated retry policy.
Developer and operational guidance
Code handling it should log the failed stage before cleanup, keep ownership and lifecycle transitions explicit, and avoid converting every failure into a generic message. Tests for this HRESULT should cover the primary cause, one adjacent HRESULT and the retry boundary so a future change cannot turn a deterministic contract failure into an uncontrolled loop.
Operational repair for this HRESULT should use supported device, Tablet PC component, recognizer and application lifecycle paths. Avoid unsupported configuration edits or component replacement unless evidence identifies that layer. Retain the original trace and a post-fix trace so the result can be attributed and the change reversed.
Practical scenario
An application hard-codes an English recognizer on a system containing only another language pack; enumerating available recognizers prevents it. The result scenario narrows the result to a reproducible contract boundary and supplies a concrete before-and-after test.
Official Microsoft references
- Microsoft: generic COM error codes
- Microsoft: RecognizerContext
- Microsoft: RealTimeStylus classes and interfaces
Looking for a different code? Search another status or error code.