PROPID_Q_PRIV_LEVEL (Windows CE 5.0)

Send Feedback

Optional. This property specifies the privacy level required by the queue.

The privacy level determines how the queue handles encrypted messages.

• Type Indicator
  VT_UI4
• PROPVARIANT Field
  ulVal
• Property Values
  This property can only be set to the following value.

  Value	Description
  MQ_PRIV_LEVEL_NONE	The queue accepts only nonprivate (clear) messages.

Remarks

The embedded implementation of MSMQ does not support privacy levels.

To set the privacy level when creating the queue, specify PROPID_Q_PRIV_LEVEL in the MQQUEUEPROPS structure and call MQCreateQueue.

To retrieve the privacy level of a queue, specify PROPID_Q_PRIV_LEVEL in the MQQUEUEPROPS structure and call MQGetQueueProperties and examine its returned value.

Examples

The following examples show how PROPID_Q_PRIV_LEVEL is specified in the MQQUEUEPROPS structure for setting and retrieving the privacy level of the queue.

To set the privacy level

DWORD dwPrivacyLevel = MQ_PRIV_LEVEL_NONE;
aPropID[i] = PROPID_Q_PRIV_LEVEL;        // Property identifier
aVariant[i].vt = VT_UI4;                 // Type indicator
aVariant[i].ulVal = dwPrivacyLevel;      // Privacy level of queue
i++;

To retrieve the privacy level

aPropID[i] = PROPID_Q_PRIV_LEVEL;       // Property identifier
aVariant[i].vt = VT_UI4;                // 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 | MQQUEUEPROPS

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.