STATUSINVALIDPARAMETER

STATUSINVALIDPARAMETER is an NTSTATUS error code used by Windows operating system components and APIs to indicate that a function was invoked with an invalid parameter. It is officially named STATUS_INVALID_PARAMETER in the Windows Native API and is defined as 0xC000000D. The status is returned by kernel-mode and user-mode interfaces when input validation fails or a parameter does not meet the required constraints.

Causes include passing a null pointer where a valid object is required, providing a buffer with an incorrect size, supplying values outside an allowed range or not enumerated, or mismatched parameter counts or structures that are not properly initialized.

Effect and handling: When a caller receives STATUS_INVALID_PARAMETER, the function fails and returns the status to its caller. In Win32 API wrappers, this NTSTATUS is typically mapped to the conventional error code ERROR_INVALID_PARAMETER (87). Applications should validate inputs before making calls and handle this status by reporting a parameter error or correcting the input.

Notes: STATUS_INVALID_PARAMETER is one of several common parameter-validation failures in the NTSTATUS family; its presence often indicates improper API usage or a bug in the caller rather than a failure of the system component.