| Previous | Next |
| MK_E_INTERMEDIATEINTERFACENOTSUPPORTED | MK_E_NOTBOUND |
MK_E_NOTBINDABLE
Moniker is not bindable
MK_E_NOTBINDABLE is the failure HRESULT 2147746280 (0x800401E8, signed -2147221016) from winerror.h. AllStat defines it as “Moniker is not bindable”. In practical terms, the moniker does not support binding to the requested object or storage. Interpret it in the context of calling BindToObject or BindToStorage on a moniker intended only for naming, comparison, or composition.
The high bit in 0x800401E8 is set, so this is a failure rather than a success or informational result. Its facility field is 4 (FACILITY_ITF) and its low 16-bit code is 488 (0x01E8). Those bit fields classify the value, but they do not identify the failing object by themselves; the native method, object identity, and first producer of MK_E_NOTBINDABLE remain essential.
Contract boundary
Understanding MK_E_NOTBINDABLE requires this subsystem context: A moniker is an object with class-specific parsing, comparison, composition, and binding behavior. For MK_E_NOTBINDABLE, display-name text alone does not establish what operations a particular moniker implementation supports.
- Associate
MK_E_NOTBINDABLEwith one exact operation in IMoniker methods, IBindCtx state, display-name parsing, composite monikers, the Running Object Table, deadlines, and object or storage binding. - Confirm that
MK_E_NOTBINDABLEcame from calling BindToObject or BindToStorage on a moniker intended only for naming, comparison, or composition, rather than from cleanup or a wrapper that ran afterward. - Preserve any IErrorInfo, underlying Win32 result, provider message, or callback failure that preceded
MK_E_NOTBINDABLE; the HRESULT alone should not erase a more specific cause.
Likely cause branches
MK_E_NOTBINDABLEcan result when the moniker class deliberately has no binding implementation.MK_E_NOTBINDABLEcan result when the caller requests object binding where only storage binding is supported, or vice versa.MK_E_NOTBINDABLEcan result when a partially constructed moniker lacks the context needed to resolve a target.
Evidence to preserve
A useful MK_E_NOTBINDABLE incident records the moniker class, display name with secrets removed, bind options and deadline, pmkToLeft, requested IID, ROT result, file identity, composite components, and object lifetime registrations in IBindCtx. For MK_E_NOTBINDABLE, also retain the application and component build, architecture, process and thread IDs, COM apartment, operation correlation ID, elapsed time, and the first state-changing event before the failure. When logging MK_E_NOTBINDABLE, redact content and credentials while preserving types, lengths, hashes, opaque identities, and lifecycle generations needed to reproduce its contract.
- For
MK_E_NOTBINDABLE, identify the exact binding method and IID. - For
MK_E_NOTBINDABLE, inspect moniker class documentation and capabilities. - For
MK_E_NOTBINDABLE, test whether composition or reduction must occur before binding.
Diagnostic sequence
- Capture
MK_E_NOTBINDABLEat the first native return before a wrapper maps it to a generic exception. - Identify the exact object, method, and lifecycle phase involved in calling BindToObject or BindToStorage on a moniker intended only for naming, comparison, or composition.
- Identify the exact binding method and IID.
- Inspect moniker class documentation and capabilities.
- Test whether composition or reduction must occur before binding.
- Reproduce
MK_E_NOTBINDABLEwith one controlled input or state change, and verify that the correction changes the decisive evidence rather than merely hiding the result.
Recovery and retry
Correction. For MK_E_NOTBINDABLE, use the supported bind method or convert/compose the moniker into a bindable form. Retry boundary. Retry after changing the method or moniker; repeated binding of the same unsupported form is deterministic. Before repeating the MK_E_NOTBINDABLE operation, release partial monikers and bound interfaces, unregister only owned Running Object Table entries, and abandon a bind context whose deadline or parameters no longer match the retry.
Practical scenario
A custom identifier moniker is designed only as a component inside a larger composite; binding it alone fails, while composing it with its root moniker succeeds. This isolates MK_E_NOTBINDABLE within COM moniker parsing, composition, binding, and storage resolution and provides a regression test for the stated correction.
Difference from related HRESULTs
MK_E_NOTBOUND describes a relationship that has not been established; MK_E_NOTBINDABLE says this moniker form cannot establish it through the requested path. For MK_E_NOTBINDABLE, keep those outcomes separate in exception mappings, telemetry dimensions, user messages, and automated retry policy.
Developer and administrator guidance
For MK_E_NOTBINDABLE, preserve the concrete moniker class, compose through IMoniker methods rather than string concatenation, set realistic bind deadlines, and request object versus storage interfaces deliberately. Regression coverage for MK_E_NOTBINDABLE should include malformed and class-specific display names, absent left-hand context, expired deadlines, unsupported inverse or enumeration operations, unavailable ROT objects, file access, and storage-only targets.
Operational repair for MK_E_NOTBINDABLE must target the evidence-backed owner: verify the named resource, file, server, or registration identified by the concrete moniker; do not infer a machine-wide COM fault from one provider-specific display name. Retain before-and-after traces for MK_E_NOTBINDABLE so the change can be attributed and reversed.
References
- Microsoft: generic COM error codes — official Microsoft documentation relevant to
MK_E_NOTBINDABLE. - Microsoft: HRESULT values — official Microsoft documentation relevant to
MK_E_NOTBINDABLE. - Microsoft: IMoniker — official Microsoft documentation relevant to
MK_E_NOTBINDABLE. - Microsoft: IBindCtx — official Microsoft documentation relevant to
MK_E_NOTBINDABLE. - Microsoft: MkParseDisplayName — official Microsoft documentation relevant to
MK_E_NOTBINDABLE.
Looking for a different code? Search another status or error code.