What does Windows error code 117 (ERROR_INVALID_CATEGORY) mean?

ERROR_INVALID_CATEGORY

What ERROR_INVALID_CATEGORY means

ERROR_INVALID_CATEGORY is a Win32 system result whose documented message is: “The IOCTL call made by the application program is not correct.” In practical troubleshooting, it belongs to legacy device-control calls where an application supplied an IOCTL category that the target driver or compatibility layer does not recognize.

Typical causes

• the request was sent to the wrong device type
• the application used a DOS or OS/2 IOCTL category unsupported by the current host
• the category and function number were encoded for a different driver version

How to investigate the result

1. Log the device path, category, function, input length, and caller architecture
2. Verify the handle was opened for the intended device class
3. Compare the request definition with the installed driver headers

Developer guidance

Use typed control-code definitions from the matching SDK and validate device identity before issuing the request. Avoid hard-coded numeric categories copied from another platform.

Administrator and support guidance

Check that the intended driver is installed and that device redirection did not replace the target with a generic device. Driver reinstall alone will not fix a caller using the wrong category.

Example

A diagnostic utility opens a printer device but sends a disk-oriented legacy IOCTL category, which the device stack rejects with this result.

How it differs from related results

ERROR_INVALID_FUNCTION may mean the function is unsupported generally; it points specifically to the category portion of a legacy IOCTL contract.

References

• Microsoft: System error codes 0–499