| Previous | Next |
| HNS_LAYER_NOT_FOUND | HNS_SUBNET_NOT_FOUND |
HNS_SWITCH_NOT_FOUND
HNS_SWITCH_NOT_FOUND is an HRESULT used by Windows Host Networking Service (HNS). It indicates that the virtual switch named by the HNS network configuration is missing or unavailable.
What to check for HNS_SWITCH_NOT_FOUND
- List Hyper-V virtual switches and compare their names and identifiers with the HNS configuration.
- Check whether a virtual switch was removed, renamed, or recreated after the network was defined.
- Recreate the dependent HNS network after restoring the intended virtual-switch configuration.
For HNS_SWITCH_NOT_FOUND, Microsoft documentation on Windows container networking and HNS
Diagnostic interpretation of HNS_SWITCH_NOT_FOUND
HNS_SWITCH_NOT_FOUND has the HRESULT value 0xC03B0004. AllStat records the condition as “The virtual switch was not found.”. For HNS_SWITCH_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_SWITCH_NOT_FOUND
- Record the exact COM method or Windows API, its input object, the calling thread, and the full 0xC03B0004 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_SWITCH_NOT_FOUND or the hns / switch / found operation.
- For HNS_SWITCH_NOT_FOUND, 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_SWITCH_NOT_FOUND
Retry HNS_SWITCH_NOT_FOUND only when the owning API documents a transient state or after the condition described as “The virtual switch was not found.” has changed. For HNS_SWITCH_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.