MSMQMessage.PrivLevel
Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista
The PrivLevel property of the MSMQMessage object specifies privacy level of the message.
| Data type: | Long |
| Run-time access: | Read/write |
Property PrivLevel As Long
Property Value
PrivLevel can be set to one of the following values:
MQMSG_PRIV_LEVEL_BODY
(Not supported for applications compiled with the header and library files for MSMQ 3.0.) Privacy is enforced, and 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, and 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, and 128-bit end-to-end encryption of the message body is used.
MQMSG_PRIV_LEVEL_NONE
The default. The message is a non-private (clear) message.
Remarks
The MSMQMessage.PrivLevel is used to request encryption by Message Queuing. For information on how Message Queuing encrypts messages, see Message Encryption.
The sending application can request encryption by setting the PrivLevel property to MQMSG_PRIV_LEVEL_BODY, MQMSG_PRIV_LEVEL_BODY_BASE, or 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 applications can use MQMSG_PRIV_LEVEL_BODY or MQMSG_PRIV_LEVEL_BODY_BASE to request 40-bit encryption, or they can use MQMSG_PRIV_LEVEL_BODY_ENHANCED to request 128-bit encryption. When requesting encryption, MSMQ 3.0 applications can use only MQMSG_PRIV_LEVEL_BODY_BASE (40-bit encryption) or MQMSG_PRIV_LEVEL_BODY_ENHANCED (128-bit encryption).
It is recommended that you use 128-bit encryption, which provides strong encoding. Attackers can decrypt data encoded with 40-bit encryption relatively easily.
Messages can also be encrypted by applications. In this case the PrivLevel property must be set as follows.
If your application is encrypting the message body with a 40-bit key, ignore the PrivLevel property when sending messages.
If your application is encrypting the message body with a 128-bit key, set PrivLevel to MQMSG_PRIV_LEVEL_BODY_ENHANCED and include it with the message.
For information on application encryption, see Application-Encrypted Messages.
Equivalent API Function Property
With API function calls, the equivalent property is PROPID_M_PRIV_LEVEL.
Example Code
The following examples are included in Using Message Queuing.
| For an example of | See |
|---|---|
| Requesting encryption when sending messages | Visual Basic Code Example: Requesting Encryption |
| Setting the privacy level of a queue to enforce encryption when creating a queue | Visual Basic Code Example: Enforcing Encryption |
Requirements
Windows NT/2000/XP: Included in Windows NT 4.0 SP3 and later.
Windows 95/98/Me: Included in Windows 95 and later.
Header: Declared in Mqoai.h.
Library: Use Mqoa.lib.
See Also
MSMQMessage
MSMQMessage.EncryptAlgorithm
PROPID_M_PRIV_LEVEL