PROPID_Q_AUTHENTICATE (Windows CE 5.0)

Send Feedback

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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.