| Previous | Next |
| HNS_REQUEST_UNSUPPORTED | HNS_DEGRADED_OPERATION |
HNS_MAPPING_NOT_SUPPORTED
HNS_MAPPING_NOT_SUPPORTED is an HRESULT used by Windows Host Networking Service (HNS). It indicates that the target network mode does not provide the requested port-mapping capability.
What to check for HNS_MAPPING_NOT_SUPPORTED
- Confirm the network driver and whether it supports HNS or WinNAT port mappings.
- Check that the mapping is being applied to the correct network and endpoint type.
- Choose a supported network mode or expose the service through an appropriate external mechanism.
For HNS_MAPPING_NOT_SUPPORTED, Microsoft documentation on Windows container networking and HNS
Diagnostic interpretation of HNS_MAPPING_NOT_SUPPORTED
HNS_MAPPING_NOT_SUPPORTED has the HRESULT value 0xC03B0016. AllStat records the condition as “Port mapping is not supported on the given network.”. For HNS_MAPPING_NOT_SUPPORTED, 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_MAPPING_NOT_SUPPORTED
- Record the exact COM method or Windows API, its input object, the calling thread, and the full 0xC03B0016 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_MAPPING_NOT_SUPPORTED or the hns / mapping / supported operation.
- For HNS_MAPPING_NOT_SUPPORTED, 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_MAPPING_NOT_SUPPORTED
Retry HNS_MAPPING_NOT_SUPPORTED only when the owning API documents a transient state or after the condition described as “Port mapping is not supported on the given network.” has changed. For HNS_MAPPING_NOT_SUPPORTED, 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.