Return Value

Parameters

A handle to a message whose application-defined properties
you want to set.

propertiesHandle

A handle to a properties object that you have created and
set using one of the set property functions. This handle is invalid after
the function returns successfully.

After you obtain the handle to a message, you can use this handle to
define its body with the MQSetBytesMessageBytes() or MQSetTextMessageText() function, and to set its header properties
with the MQSetMessageHeaders() function.

Property values are set prior to sending a message. The MQSetMessageProperties function allows you to set application-defined properties for a
message. For example, application-defined properties allow an application,
via message selectors, to select or filter, messages on its behalf using application-specific
criteria.

You define the message properties and their values using the MQCreateProperties() function
to create a properties object, then you use one of the set property functions
to define each key and value in it. See Working With Properties for more information.