PROPID_Q_AUTHENTICATE (Windows CE 5.0)
Optional. This property specifies whether the queue accepts only authenticated messages.
- Type Indicator
VT_UI1 - PROPVARIANT Field
bVal - Property Values
This property can be set only to the following value.Value Description MQ_AUTHENTICATE_NONE The default. The queue accepts authenticated and nonauthenticated messages.
Remarks
The embedded implementation of MSMQ does not support authentication.
To set the initial authentication level of a new queue, specify PROPID_Q_AUTHENTICATE in the MQQUEUEPROPS structure and call MQCreateQueue.
To set the authentication level of an existing queue, specify PROPID_Q_AUTHENTICATE in the MQQUEUEPROPS structure and call MQSetQueueProperties.
When changing the authentication level of the queue, the new setting impacts only arriving messages; it does not affect messages already in the queue.
To retrieve the authentication level of an existing queue, specify PROPID_Q_AUTHENTICATE in the MQQUEUEPROPS structure; then call MQGetQueueProperties and examine its returned value.
Examples
The following examples show how PROPID_Q_AUTHENTICATE is specified in the MQQUEUEPROPS structure for setting and retrieving the authentication level of a queue.
To set the authentication level
aPropID[i] = PROPID_Q_AUTHENTICATE; // Property identifier
aVariant[i].vt = VT_UI1; // Type indicator
aVariant[i].bVal = MQ_NONE_AUTHENTICATE; // Authentication level of queue
i++;
To retrieve the authentication level
aPropID[i] = PROPID_Q_AUTHENTICATE; // Property identifier
aVariant[i].vt = VT_UI1; // Type indicator
i++;
Requirements
OS Versions: Windows CE 2.0 and later. Versions prior to 2.12 require the MSMQ add-on pack.
Header: Mq.h.
See Also
MQCreateQueue | MQGetQueueProperties | MQSetQueueProperties | MQQUEUEPROPS
Send Feedback on this topic to the authors