PROPID_M_AUTH_LEVEL

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. When the authentication level of a message is set to MQMSG_AUTH_LEVEL_ALWAYS, MSMQ digitally signs the message when it is sent and then uses the digital signature to authenticate the message when it is received.

To set the authentication level of a message, specify PROP_M_AUTH_LEVEL in the MQMSGPROPS structure 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 will be rejected when it reaches the queue.

Example

This example shows how PROPID_M_AUTH_LEVEL is specified in the MQMSGPROPS structure.

aMsgPropId[i] = PROPID_M_AUTH_LEVEL;    // Property ID
aMsgPropVar[i].vt = VT_UI4;             // Type indicator
aMsgPropVar[i].bVal = MQMSG_AUTH_LEVEL_NONE;
i++;

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later. Versions prior to 2.12 require the MSMQ add-on pack. Mq.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

MQSendMessage, MQMSGPROPS

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.