2460 (099C) (RC2460): MQRC_HMSG_ERROR


Explanation

On an MQCRTMH, MQDLTMH, MQSETMP, MQINQMP or MQDLT call, a message handle supplied is not valid, for one of the following reasons:

  • The parameter pointer is not valid, or (for the MQCRTMH call) points to read-only storage. (It is not always possible to detect parameter pointers that are not valid; if not detected, unpredictable results occur.)
  • The value specified was not returned by a preceding MQCRTMH call.
  • The value specified has been made invalid by a preceding MQDLTMH call.


Completion code

MQCC_FAILED


Programmer response

Ensure that a successful MQCRTMH call is performed for the connection, and that an MQDLTMH call has not already been performed for it. Ensure that the handle is being used within its valid scope, for more information, see MQCRTMH - Create message handle.

Parent topic: API reason codes