What does Windows error code 140 (ERROR_JOIN_TO_SUBST) mean?

ERROR_JOIN_TO_SUBST

What ERROR_JOIN_TO_SUBST means

ERROR_JOIN_TO_SUBST is a Win32 system result whose documented message is: “The system tried to join a drive to a directory on a substituted drive.” In practical troubleshooting, it belongs to legacy mapping rules that prohibit joining a drive to a directory located on a substituted drive.

Typical causes

• the target path uses a SUBST letter instead of its physical location
• configuration combines two independent mapping mechanisms
• path canonicalization occurred after validation rather than before it

How to investigate the result

1. translate the target drive letter to its real directory
2. Inspect mapping order during logon or startup
3. retry with the canonical physical path in a disposable environment

Developer guidance

Canonicalize paths before validating mapping topology and avoid mixing JOIN with SUBST in maintained configurations.

Administrator and support guidance

Replace the target alias with its actual volume path. Document mapping creation order so later scripts do not unknowingly depend on aliases.

Example

An old installer attempts to JOIN a data drive to S:\Data, while S: is a SUBST alias, causing this result.

How it differs from related results

It rejects JOIN whose target traverses SUBST; ERROR_SUBST_TO_JOIN covers the reverse combination.

References

• Microsoft: System error codes 0–499