| Previous | Next |
| WCM_E_INTERNALERROR | WCM_E_STATENODENOTALLOWED |
WCM_E_STATENODENOTFOUND
WCM_E_STATENODENOTFOUND is the failure HRESULT 0x80220001 (signed decimal -2145255423, unsigned decimal 2149711873). Its severity bit is 1, facility is 34 (FACILITY_STATE_MANAGEMENT), and the facility-specific code field is 0x0001.
AllStat records the Windows SDK description as “State node is not found.”
What the HRESULT establishes
A settings-tree path resolved to no state node. The operation reached lookup, navigation, creation-relative access, or removal of an item in the SMI settings tree. The first branch to test is whether the path was copied from another Windows image whose namespace schema differs; keep that separate from the possibility that a list element was removed or renamed before a later operation reused its path.
Processing stage
At this boundary, capture the opaque path returned by ISettingsItem::GetPath rather than a reconstructed string, then correlate it with namespace identity, access mode, target image, and current parent item. Assign ownership only after checking whether the failing path is absolute, relative, keyed-list, or attribute-oriented.
Failure patterns to separate
- the path was copied from another Windows image whose namespace schema differs
- a list element was removed or renamed before a later operation reused its path
- the caller treated an attribute path as a setting path, or used the wrong current item as the relative root
- the namespace opened successfully but the requested component or optional setting is not present in that image
Capture these facts first
- the opaque path returned by ISettingsItem::GetPath rather than a reconstructed string
- namespace identity, access mode, target image, and current parent item
- whether the failing path is absolute, relative, keyed-list, or attribute-oriented
- an enumeration of the parent item and its actual children at failure time
- the operation type: get, remove, revert, create-relative, or context deserialization
A safe investigation order
- open the intended namespace and reacquire the parent item from the current engine
- enumerate children or list keys instead of guessing names
- preserve paths as opaque values and pass them only to documented path APIs
- handle an optional missing setting as absence when the product contract allows it
- repair the producer if a required node is omitted from the manifest or target image
Recovery conditions
Retry becomes meaningful only after correcting the path, recreating the node, or reopening the correct target. Repeating the same lookup cannot create the missing state.
Do not confuse it with adjacent codes
WCM_E_INVALIDPATH means the path syntax is malformed; WCM_E_INVALIDKEY means a keyed-list selector conflicts with the schema. This code says the path is usable but identifies no node.
Deployment example
A migration tool stores a path from one OS build and applies it to an image where that optional feature is absent. Enumerating the parent shows the node was never registered in the target schema.
Telemetry fields worth retaining
For operational telemetry, retain whether the failing path is absolute, relative, keyed-list, or attribute-oriented; also record an enumeration of the parent item and its actual children at failure time. Preserve a redacted summary of the operation type: get, remove, revert, create-relative, or context deserialization; use a cryptographic hash when that evidence is a file, stream, or generated artifact.
Official Microsoft references.
- Microsoft: SMI error and success constants.
- Microsoft: Settings Management Infrastructure API.
- Microsoft: SMI interfaces.
- Microsoft: ISettingsItem::GetPath.
- Microsoft: ISettingsItem::RemoveSettingByPath.
Looking for a different code? Search another status or error code.