| Previous | Next |
| HNS_INVALID_JSON | HNS_ENDPOINT_SHARING_DISABLED |
HNS_INVALID_JSON_REFERENCE
HNS_INVALID_JSON_REFERENCE is an HRESULT used by Windows Host Networking Service (HNS). It indicates that one JSON field references an object, identifier, or path that cannot be resolved.
What to check for HNS_INVALID_JSON_REFERENCE
- Check every referenced network, endpoint, policy, adapter, and GUID in the submitted document.
- Create dependent HNS objects before submitting a configuration that refers to them.
- Avoid copying references from a different host or a previously deleted network.
For HNS_INVALID_JSON_REFERENCE, Microsoft documentation on Windows container networking and HNS
Diagnostic interpretation of HNS_INVALID_JSON_REFERENCE
HNS_INVALID_JSON_REFERENCE has the HRESULT value 0xC03B001C. AllStat records the condition as “The reference is invalid in the JSON document.”. For HNS_INVALID_JSON_REFERENCE, in practice, interpret that wording at the boundary owned by the Windows component or COM interface that returned the HRESULT, rather than treating the value as a generic Windows message.
Evidence to capture for HNS_INVALID_JSON_REFERENCE
- Record the exact COM method or Windows API, its input object, the calling thread, and the full 0xC03B001C value before a wrapper converts it to an exception or Boolean result.
- Capture any IErrorInfo text, activity identifier, event-log entry, and subsystem trace that mentions HNS_INVALID_JSON_REFERENCE or the hns / json / reference operation.
- For HNS_INVALID_JSON_REFERENCE, check the documented return contract of the specific API because the same HRESULT can require different recovery in different interfaces.
Retry and recovery for HNS_INVALID_JSON_REFERENCE
Retry HNS_INVALID_JSON_REFERENCE only when the owning API documents a transient state or after the condition described as “The reference is invalid in the JSON document.” has changed. For HNS_INVALID_JSON_REFERENCE, configuration, policy, format, and authorization failures normally require correction first; an immediate loop can hide the original call site and add secondary errors.
Looking for a different code? Search another status or error code.