What does HRESULT 0xC00E0041 (MQ_ERROR_ILLEGAL_MQQMPROPS) mean?

MQ_ERROR_ILLEGAL_MQQMPROPS

What this result actually narrows down

Applications should keep MQ_ERROR_ILLEGAL_MQQMPROPS attached to the exact MSMQ call that produced it. In this case the relevant subject is invalid machine-property request structure. MQQMPROPS must contain a nonzero coherent property set for machine information APIs.

Validation occurs in layers: identifier recognition, variant type, buffer shape, value range, required companions, and operation eligibility. When diagnosing this result, these layers correspond to different MSMQ HRESULTs and different fixes.

MSMQ uses arrays whose indexes bind a property identifier, an MQPROPVARIANT value, and optionally a status result. Misaligned counts or reordered arrays can make the logged property differ from the one actually rejected.

MSMQ objects involved

Do not merge it with other property failures: identifier, VARTYPE, value, size, required companions, and operation eligibility are diagnosed by different codes. The code-specific boundary is invalid machine-property request structure.

Triage data

• The complete apropid/apropvar/astatus triples in original order.
• The api name and whether the structure was input, output, or both.
• The first failing property rather than only the aggregate hresult.

Correct response

Initialize the machine property arrays and inspect aStatus for per-property results.

What this code is not

Changing a queue ACL or restarting the service does not correct an invalid identifier, VARTYPE, value, structure, or property combination. Code-specific condition: invalid machine-property request structure.

Example failure path

Technical references

• Microsoft: Message Queuing error and information codes
• Microsoft: queue properties and MQQUEUEPROPS
• Microsoft: MSMQ message properties
• Microsoft: MQCreateQueue