Parameters

producerHandle

The handle to the producer sending this message. This handle is passed back to you by the MQCreateMessageProducerForDestination() function.

messageHandle

A handle to the message you want to send.

The MQSendMessage function sends the specified message on behalf of the specified producer to the destination associated with the message producer. If you use this function to send a message, the following message header fields are set to default values when the send completes.

• MQ_PERSISTENT_HEADER_PROPERTY will be set to MQ_PERSISTENT_DELIVERY.

  This means that the calling thread will be blocked, waiting for the broker to acknowledge receipt of your messages, unless you set the connection property MQ_ACK_ON_PRODUCE_PROPERTY to MQ_FALSE.

• MQ_PRIORITY_HEADER_PROPERTY will be set to 4.

• MQ_EXPIRATION_HEADER_PROPERTY will be set to 0, which means that the message will never expire.

If you set those message properties, they will be ignored when a message is sent. To send a message with these properties set to different values, you can use the MQSendMessageExt() function to specify different values for these properties.

You cannot use this function with a producer that is created without a specified destination.