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
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.