This property specifies the queue to which application-generated response messages are returned.
- Type Indicator
- PROPVARIANT Field
- Property Values
Format name of the response queue (the default is none).
PROPID_M_RESP_QUEUE is used to send the format name of a queue to the receiving application. Typically, this is done so that the receiving application can send a response message back to the sending application.
This property can also be used to send the format name of other queues. For example, you can set this property to the format name of destination queue of the original message when you create a response message. You can also use this property to send the format name of a local private queue, which would be inaccessible otherwise, to another application.
Response messages are application-defined. The sending and receiving application must define what is in the message, as well as what is to be done when the response message arrives in the response queue.
Before using the returned value of PROPID_M_RESP_QUEUE, always inspect the returned value of PROPID_M_RESP_QUEUE_LEN to see if a response message was requested. A returned value of 0 indicates that a response queue was not specified by the sending application and no response message is needed. A nonzero return value indicates that the format name of a response queue was returned by PROPID_M_RESP_QUEUE.
The following examples show how PROPID_M_RESP_QUEUE is specified in the MQMSGPROPS structure for setting and retrieving the response queue format name.
To send the format name
aMsgPropId[i] = PROPID_M_RESP_QUEUE; // Property ID aMsgPropVar[i].vt = VT_LPWSTR; // Type indicator aMsgPropVar[i].pwszVal = wszRespFormatNameBuffer; i++;
To retrieve the format name
aMsgPropId[i] = PROPID_M_RESP_QUEUE_LEN; // Property ID aMsgPropVar[i].vt = VT_UI4; // Type indicator aMsgPropVar[i].ulVal = dwRespFormatNameBufferLength; i++; aMsgPropId[i] = PROPID_M_RESP_QUEUE; // Property ID aMsgPropVar[i].vt = VT_LPWSTR; // Type indicator aMsgPropVar[i].pwszVal = wszRespFormatNameBuffer; i++;
|Runs on||Versions||Defined in||Include||Link to|
|Windows CE OS||2.0 and later. Versions prior to 2.12 require the MSMQ add-on pack.||Mq.h|
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.