| Previous | Next |
| CO_E_WRONGOSFORAPP | CO_E_OBJISREG |
CO_E_OBJNOTREG
Object is not registered
Meaning and numerical form
CO_E_OBJNOTREG is HRESULT 2147746299 (0x800401FB; signed -2147220997). For CO_E_OBJNOTREG, AllStat records its meaning as “Object is not registered”. In practical terms, it is returned when an object-registration operation expects a live object entry but no matching registration is present.
The severity bit in 0x800401FB is set, so CO_E_OBJNOTREG is a failure result rather than a success or informational status. Its facility is 4 (FACILITY_ITF) and its low 16-bit code is 507 (0x01FB). For CO_E_OBJNOTREG, those fields classify the value but do not identify the component instance, call, object or input that produced it.
Evidence to collect
A useful CO_E_OBJNOTREG record 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 CO_E_OBJNOTREG, preserve IErrorInfo, an inner HRESULT, Win32 status, device event or provider message when available.
- Capture 1 for
CO_E_OBJNOTREG: the exact registration API, identity key and registration token used by the producer. - Capture 2 for
CO_E_OBJNOTREG: timestamps for registration, revocation and the failed lookup. - Capture 3 for
CO_E_OBJNOTREG: process lifetime and running-object-table state in the same user session.
Telemetry for CO_E_OBJNOTREG should retain types, lengths, hashes, stable opaque identifiers and lifecycle generations while redacting content and credentials. For CO_E_OBJNOTREG, this makes repeated incidents comparable without exposing paths, object identities, user data or credentials.
Where the failure belongs
CO_E_OBJNOTREG belongs to COM activation and object lifetime. For CO_E_OBJNOTREG, COM activation is a sequence rather than one registry lookup: identifier resolution, class registration, module or process start, class-factory publication, marshaling, and object lifetime can fail independently. For CO_E_OBJNOTREG, the decisive condition is this: an object-registration operation expects a live object entry but no matching registration is present. For CO_E_OBJNOTREG, record the first native producer instead of relying only on a framework exception translated several layers later.
Do not infer from CO_E_OBJNOTREG alone that reinstalling, rebooting or repeating the whole workflow is appropriate. Because CO_E_OBJNOTREG 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
CO_E_OBJNOTREG: the producer never registered the object instance. - Possible cause 2 for
CO_E_OBJNOTREG: the registration was revoked during shutdown or recovery. - Possible cause 3 for
CO_E_OBJNOTREG: the lookup key, moniker or object identity differs from the value used at registration.
Diagnostic sequence
- Capture
CO_E_OBJNOTREGat the first native return and identify the exact object and method. - Confirm that the observed path matches this
CO_E_OBJNOTREGcondition: an object-registration operation expects a live object entry but no matching registration is present. - For
CO_E_OBJNOTREG, compare the live state with the method contract before changing configuration. - For
CO_E_OBJNOTREG, collect the code-specific evidence listed above and preserve any more specific preceding error. - For
CO_E_OBJNOTREG, change one evidence-backed cause at a time, then repeat the smallest operation that can prove the correction. - Add a regression check that distinguishes
CO_E_OBJNOTREGfrom the related outcomes described below.
Correction and retry boundary
- Corrective action 1 for
CO_E_OBJNOTREG: register the object before exposing discovery to clients. - Corrective action 2 for
CO_E_OBJNOTREG: use the same canonical identity for registration and lookup. - Corrective action 3 for
CO_E_OBJNOTREG: serialize shutdown so revocation cannot race an in-flight consumer.
Retry guidance for CO_E_OBJNOTREG. Retry after a producer has created a new registration; blind polling should be bounded and tied to observable server startup. A CO_E_OBJNOTREG retry must avoid this hazard: launch duplicate servers, reuse stale proxies or repeat an activation whose side effects are unknown. It must also preserve the evidence needed to locate the original producer of CO_E_OBJNOTREG.
Difference from nearby HRESULTs
REGDB_E_CLASSNOTREG concerns class activation metadata, while CO_E_OBJNOTREG concerns a missing live object registration. For CO_E_OBJNOTREG, keep these outcomes separate in logs, exception mappings, user messages, dashboards and automated retry policy.
Developer and operational guidance
Code handling CO_E_OBJNOTREG should log the failed stage before cleanup, keep ownership and lifecycle transitions explicit, and avoid converting every failure into a generic message. Tests for CO_E_OBJNOTREG 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 CO_E_OBJNOTREG should use supported product installation, COM registration, activation and class-factory lifetime paths. For CO_E_OBJNOTREG, avoid unsupported configuration edits or component replacement unless evidence identifies that layer. For CO_E_OBJNOTREG, retain the original trace and a post-fix trace so the result can be attributed and the change reversed.
Practical scenario
A document server revokes its running-object entry during restart while a client still looks up the old moniker; waiting for the new registration resolves CO_E_OBJNOTREG. The CO_E_OBJNOTREG 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 — official documentation relevant to
CO_E_OBJNOTREG. - Microsoft: IRunningObjectTable — official documentation relevant to
CO_E_OBJNOTREG. - Microsoft: CoCreateInstance — official documentation relevant to
CO_E_OBJNOTREG.
Looking for a different code? Search another status or error code.