Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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 implementation of MSMQ does not support authentication.

To set the initial authentication level of a new queue, specify PROPID_Q_AUTHENTICATE in the MQQUEUEPROPSstructure and call MQCreateQueue.

To set the authentication level of an existing queue, specify PROPID_Q_AUTHENTICATE in the MQQUEUEPROPSstructure 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 MQQUEUEPROPSstructure; then call MQGetQueuePropertiesand examine its returned value.

Examples

The following examples show how PROPID_Q_AUTHENTICATE is specified in the MQQUEUEPROPSstructure for setting and retrieving the authentication level of a queue.

To set the authentication level

Copy Code 
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

Copy Code 
aPropID[i] = PROPID_Q_AUTHENTICATE;   // Property identifier
aVariant[i].vt = VT_UI1; 		// Type indicator
i++;
Note:
OS versions prior to 2.12 require the MSMQ add-on pack.

Requirements

Header mq.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also