| Previous | Next |
| HNS_NETWORK_ALREADY_EXISTS | HNS_POLICY_ALREADY_EXISTS |
HNS_LAYER_ALREADY_EXISTS
HNS_LAYER_ALREADY_EXISTS is an HRESULT used by Windows Host Networking Service (HNS). It indicates that creating the underlying layer collided with an already registered HNS layer.
What to check for HNS_LAYER_ALREADY_EXISTS
- Inspect the existing network and layer state before retrying the create request.
- Verify whether another runtime instance or provisioning task created the layer first.
- Serialize concurrent provisioning so that only one workflow owns layer creation.
For HNS_LAYER_ALREADY_EXISTS, Microsoft documentation on Windows container networking and HNS
Diagnostic interpretation of HNS_LAYER_ALREADY_EXISTS
HNS_LAYER_ALREADY_EXISTS has the HRESULT value 0xC03B0011. AllStat records the condition as “A network with this name already exists.”. For HNS_LAYER_ALREADY_EXISTS, 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_ALREADY_EXISTS
- Record the exact COM method or Windows API, its input object, the calling thread, and the full 0xC03B0011 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_ALREADY_EXISTS or the hns / layer / already / exists operation.
- Reproduce HNS_LAYER_ALREADY_EXISTS with the smallest valid input and note whether the result changes with identity, architecture, service state, or target object.
Retry and recovery for HNS_LAYER_ALREADY_EXISTS
Retry HNS_LAYER_ALREADY_EXISTS only when the owning API documents a transient state or after the condition described as “A network with this name already exists.” has changed. For HNS_LAYER_ALREADY_EXISTS, 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.