Modifications de l'interface dans les programmes client C et C-API

• Nouvelle fonction : MQGetDestinationName()

  MQGetDestinationName (const MQDestinationHandle destinationHandle, MQString * destinationName);

  Utilisez cette fonction pour obtenir le nom d'une destination. Le destinationName renvoyé est une copie que le programme appelant doit libérer via la fonction MQFreeString().

  Paramètres

  destinationHandle

  Un identificateur (handle) vers la destination dont vous souhaitez connaître le nom.

  destinationName

  Paramètre de sortie pour le nom.

  Cette fonction s'avère pratique lorsque l'on utilise le modèle Répondre à. Vous pouvez utiliser la fonction MQGetMessageReplyTo pour obtenir un identificateur vers la destination du message. Vous pouvez ensuite utiliser la fonction MQGetDestinationName pour obtenir le nom de cette destination. Après avoir obtenu le nom de la destination, vous pouvez traiter vos messages selon le nom.

• Nouvelle valeur d'énumération : MQ_MESSAGE

  La nouvelle fonction MQMessageType, MQ_MESSAGE, permet aux clients C d'échanger des messages de type Message avec d'autres clients Message Queue qui utilisent C et Java :

  typedef enum _MQMessageType {MQ_TEXT_MESSAGE = 0, MQ_BYTES_MESSAGE = 1, MQ_MESSAGE = 3, MQ_UNSUPPORTED_MESSAGE = 2} MQMessageType;

  Le type MQ_MESSAGE identifie les messages comportant un en-tête et des propriétés mais pas de corps de message. Utilisez la fonction MQCreateMessage() pour créer un message de ce type.

• Une nouvelle propriété de connexion, MQ_UPDATE_RELEASE_PROPERTY, qui spécifie la version de mise à jour de la version installée de Message Queue. Utilisez la fonction MQGetMetaData() pour obtenir des informations sur cette version.