Partager via

PROPID_M_SECURITY_CONTEXT

  • Article

 

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

(Write-only.) The PROPID_M_SECURITY_CONTEXT property specifies a handle to a security context structure that contains a user certificate, the corresponding private key, the user's SID, and other information needed to attach the certificate to a message.

Property ID

PROPID_M_SECURITY_CONTEXT

Type Indicator

VT_UI4

MQPROPVARIANT Field

ulVal

Property Value

Handle to a security context buffer returned by MQGetSecurityContextEx.

Remarks

The sending application should use PROPID_M_SECURITY_CONTEXT when using the same certificate to send a large number of authenticated messages. The Message Queuing runtime uses the handle to the security context structure specified by PROPID_M_SECURITY_CONTEXT to attach the certificate to the messages for you.

All the information in a security context structure is stored locally on the source computer and has no meaning to the receiving application.

To create a security context structure, call MQGetSecurityContextEx. The certificate included can be an internal or external certificate.

When using a security context structure to attach a certificate, do not set PROPID_M_SENDER_CERT. The Message Queuing runtime will attach the certificate for you. If the Message Queuing runtime finds a different certificate in PROPID_M_SENDER_CERT, it will ignore any information in PROPID_M_SECURITY_CONTEXT.

When the sending application is impersonating a user, it must use the security context of the impersonated user.

The PROPID_M_SECURITY_CONTEXT property is write-only. If the receiving application attempts to retrieve the PROPID_M_SECURITY_CONTEXT property, MQReceiveMessage or MQReceiveMessageByLookupId returns the warning MQ_INFORMATION_PROPERTY, the individual result for the PROPID_M_SECURITY_CONTEXT property is MQ_INFORMATION_PROPERTY_IGNORED, and the other properties are received correctly.

When the current security context structure is no longer needed, call MQFreeSecurityContext to clear the memory allocated for this structure.

For information on See
Attaching the security context using a COM method MSMQMessage.AttachCurrentSecurityContext
Using a security context structure When to Use a Security Context Structure
How to retrieve the security context of another user Impersonating a User

See Also

Message Properties
MQMSGPROPS
MQFreeSecurityContext
MQGetSecurityContext
MQSendMessage
PROPID_M_SENDER_CERT