What does Windows error code 159 (ERROR_BAD_THREADID_ADDR) mean?

ERROR_BAD_THREADID_ADDR

What ERROR_BAD_THREADID_ADDR means

The address supplied for receiving or referencing a thread identifier is invalid. The status points to a bad memory contract around a thread-ID parameter. In legacy APIs the caller may provide a pointer where the runtime writes an identifier; an invalid, misaligned, read-only, or incorrectly sized address causes this result.

Common causes

• A null or dangling pointer is passed for the thread ID
• The buffer is read-only or belongs to an unloaded module
• 32-bit and 64-bit code disagree on field size
• The address is valid initially but another thread frees it too early

How to investigate

1. Log the pointer value, buffer size, and owning allocation
2. Enable page heap or memory diagnostics on the producing process
3. Check ABI declarations and calling convention
4. Reduce asynchronous lifetime so the output buffer remains valid through completion

Developer guidance

Use the exact declared type for thread identifiers and keep output storage alive for the entire call. Do not cast integer storage or packed network fields into pointer parameters.

Administrator and support guidance

This is generally an application defect. Preserve a crash dump or verifier report rather than attempting system-wide thread configuration changes.

How this code differs from related results

The code concerns the address of the thread-ID storage, not whether the referenced thread itself exists.

References

• Microsoft: System error codes 0–499