Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This property specifies privacy level of the message.
HRESULT get_PrivLevel( long* plPrivLevel);HRESULT put_PrivLevel( longlPrivLevel);
Parameters
- plPrivLevel or lPrivLevel
Value that indicates the privacy level of the message. The following table shows the possible values.Value Description MQMSG_PRIV_LEVEL_BODY Privacy is enforced. 40-bit end-to-end encryption of the message body is used. MQMSG_PRIV_LEVEL_BODY_BASE (Introduced in MSMQ 2.0.) Privacy is enforced. 40-bit end-to-end encryption of the message body is used. MQMSG_PRIV_LEVEL_BODY_ENHANCED (Introduced in MSMQ 2.0.) Privacy is enforced. 128-bit end-to-end encryption of the message body is used. MQMSG_PRIV_LEVEL_NONE The default. The message is a nonprivate (clear) message.
Return Values
The following table describes the common return values.
| Value | Description |
|---|---|
| S_OK | Success |
| E_INVALIDARG | One or more arguments are invalid |
| E_NOTIMPL | The function contains no implementation |
| E_OUTOFMEMORY | Out of memory |
Remarks
The MSMQMessage.PrivLevel is used to request encryption by Message Queuing.
The sending application can request encryption by setting the MSMQMessage.PrivLevel property to one of the following:
- MQMSG_PRIV_LEVEL_BODY
- MQMSG_PRIV_LEVEL_BODY_BASE
- MQMSG_PRIV_LEVEL_BODY_ENHANCED
When one of these settings is used, the body of the message is encrypted with the algorithm specified by MSMQMessage.EncryptAlgorithm.
**Note **MSMQ 2.0 and MSMQ 3.0 applications can use MQMSG_PRIV_LEVEL_BODY or MQMSG_PRIV_LEVEL_BODY_BASE to request 40-bit encryption.
Application Encrypted Messages
Messages can also be encrypted by applications. In this case the MSMQMessage.PrivLevel property must be set as follows.
- If your application is encrypting the message body with a 40-bit key, ignore the MSMQMessage.PrivLevel property when sending messages.
- If your application is encrypting the message body with a 128-bit key, set MSMQMessage.PrivLevel to MQMSG_PRIV_LEVEL_BODY_ENHANCED and include it with the message.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Mqoai.h.
Link Library: Mqoa.lib.
Send Feedback on this topic to the authors