| Previous | Next |
| HNS_ENDPOINT_NOT_FOUND | HNS_SWITCH_NOT_FOUND |
HNS_LAYER_NOT_FOUND
HNS_LAYER_NOT_FOUND is an HRESULT used by Windows Host Networking Service (HNS). It indicates that HNS could not resolve the layer required by the target virtual network.
What to check for HNS_LAYER_NOT_FOUND
- Verify the selected network driver and the host components required by that driver.
- Inspect the network definition for stale layer references after upgrades, resets, or configuration changes.
- Recreate only the affected network after preserving the configuration needed to reproduce the issue.
For HNS_LAYER_NOT_FOUND, Microsoft documentation on Windows container networking and HNS
Diagnostic interpretation of HNS_LAYER_NOT_FOUND
HNS_LAYER_NOT_FOUND has the HRESULT value 0xC03B0003. AllStat records the condition as “The network's underlying layer was not found.”. For HNS_LAYER_NOT_FOUND, 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_LAYER_NOT_FOUND
- Record the exact COM method or Windows API, its input object, the calling thread, and the full 0xC03B0003 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_LAYER_NOT_FOUND or the hns / layer / found operation.
- For HNS_LAYER_NOT_FOUND, compare the failing machine with a working one at the same configuration boundary: component version, policy, registration, identity, and target resource.
Retry and recovery for HNS_LAYER_NOT_FOUND
Retry HNS_LAYER_NOT_FOUND only when the owning API documents a transient state or after the condition described as “The network's underlying layer was not found.” has changed. For HNS_LAYER_NOT_FOUND, 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.