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

This property specifies if the message needs to be authenticated.

Type Indicator

VT_UI4

PROPVARIANT Field

ulVal

Property Values

Set this property to only the following value.

Value Description

MQMSG_AUTH_LEVEL_NONE

The default. The message is not signed. MSMQ does not need to authenticate the message when it reaches the queue.

Remarks

The PROPID_M_AUTH_LEVEL property is only used by the sending application.

To set the authentication level of a message, specify PROP_M_AUTH_LEVEL in the MQMSGPROPSstructure and call MQSendMessage.

When the authentication level of a message is set to MQMSG_AUTH_LEVEL_NONE and the authentication level of the target queue is set to force authentication, the message is rejected when it reaches the queue.

Examples

This example shows how PROPID_M_AUTH_LEVEL is specified in the MQMSGPROPSstructure.

Copy Code 
aMsgPropId[i] = PROPID_M_AUTH_LEVEL; // Property ID
aMsgPropVar[i].vt = VT_UI4; 		 // Type indicator
aMsgPropVar[i].ulVal = MQMSG_AUTH_LEVEL_NONE;
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