PROPID_Q_AUTHENTICATE

Optional. The PROPID_Q_AUTHENTICATE property specifies whether or not the queue only accepts authenticated messages.

Type Indicator
VT_UI1
PROPVARIANT Field
bVal
Property Values
This property can be set to one of the following values:
MQ_AUTHENTICATE_NONE
The default. The queue accepts authenticated and non-authenticated messages.
MQ_AUTHENTICATE
The queue only accepts authenticated messages.

Remarks

If the authentication level of the message (PROPID_M_AUTH_LEVEL) does not match the authentication level of the queue, the message is rejected by the queue. In addition, if the sending application requested a negative acknowledgment message when it sent the message, MQMSG_CLASS_NACK_BAD_SIGNATURE will be returned to the sending application to indicate the message was rejected.

For information on how MSMQ authenticates messages, see Message Authentication.

To set the authentication level of the queue, pass PROPID_Q_AUTHENTICATE to MQCreateQueue when creating the queue.

To change the authentication level of the queue, pass PROPID_Q_AUTHENTICATE to MQSetQueueProperties. When changing the authentication level of the queue, the new setting only impacts arriving messages; it does not affect messages already in the queue.

To determine the authentication level of a queue, pass PROPID_Q_AUTHENTICATE to MQGetQueueProperties and examine its returned value.

The receiving application can also check if a message was authenticated by looking at the message's PROPID_M_AUTHENTICATED property.

See Also

MQCreateQueue, MQGetQueueProperties, MQSetQueueProperties, PROPID_M_AUTH_LEVEL, PROPID_M_AUTHENTICATED


© 1997 by Microsoft Corporation. All rights reserved.