PROPID_M_AUTH_LEVEL

The PROPID_M_AUTH_LEVEL property specifies if the message needs to be authenticated.

Type Indicator

VT_UI4

PROPVARIANT Field

ulVal

Property Values

This property can be set to one of the following values:

MQMSG_AUTH_LEVEL_NONE

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

MQMSG_AUTH_LEVEL_ALWAYS

MSMQ must sign the message when it is sent and authenticate the message when it reaches the queue.

Remarks

The PROPID_M_AUTH_LEVEL property is only used by the sending application.

To authenticate a message, MSMQ digitally signs the message when it is sent, then uses the digital signature to authenticate the message when it is received. For information on how MSMQ creates the digital signature and how it authenticates the received message, see Message Authentication.

If PROPID_M_AUTH_LEVEL is set to MQMSG_AUTH_LEVEL_NONE and the target queue is set to force authentication, the message will be rejected when it reaches the queue.

QuickInfo

  Windows NT: Requires version 4.0 SP3 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mq.h.
  Import Library: Use mqrt.lib.
  Unicode: Defined only as Unicode.