Oracle GlassFish Message Queue 4.4.2 Developer's Guide for C Clients

Parameters

messageHandle

The message handle.

headersHandle

Output parameter for the handle to the message header properties.

The MQGetMessageHeaders function passes back a handle to the message headers. The message header includes the fields described in Table 4–5. Note that most of the fields are set by the send function; the client can optionally set only two of these fields for sending messages.

Table 4–5 Message Header Properties

Key 

Type 

Set By 

MQ_CORRELATION_ID_HEADER_PROPERTY


MQString

Client (optional) 

MQ_MESSAGE_TYPE_HEADER_PROPERTY


MQString

Client (optional) 

MQ_PERSISTENT_HEADER_PROPERTY


MQBool

Send function 

MQ_EXPIRATION_HEADER_PROPERTY


MQInt64

Send function 

MQ_PRIORITY_HEADER_PROPERTY


MQInt8

Send function 

MQ_TIMESTAMP_HEADER_PROPERTY


MQInt64

Send function 

MQ_MESSAGE_ID_HEADER_PROPERTY


MQString

Send function 

MQ_REDELIVERED_HEADER_PROPERTY


MQBool

Message Broker 

You are responsible for freeing the headersHandle after you are done with it. Use the MQFreeProperties() function to free the handle.

Use the MQSetBytesMessageBytes() MQGetMessageProperties() function to determine whether any application-defined properties were set for this message and to find out their value.