PROPID_M_SENDER_CERT

The PROPID_M_SENDER_CERT property specifies the external certificate used to authenticate messages.

Type Indicator

VT_VECTOR | VT_UI1

PROPVARIANT Field

caub

Property Values

Security certificate (the default is the internal certificate provided by MSMQ).

Remarks

The sending application must obtain an external certificate from a certification authority or use the internal certificate provided by MSMQ.

There are two ways to specify the security information provided by an external certificate.

• If the sending application uses the certificate only once, place the complete certificate in PROPID_M_SENDER_CERT and attach the property to the message.
• If the sending application uses the same certificate over and over, call MQGetSecurityContext to retrieve the security information from the certificate, place it in PROPID_M_SECURITY_CONTEXT, and attach the property to the message.

When PROPID_M_SENDER_CERT is used, any certificate information in PROPID_M_SECURITY_CONTEXT is ignored, but the user information is still valid. Either property can be used when authenticating messages with an external certificate.

When an external certificate is specified, the receiving application can use the information in the certificate to verify who sent the message. When the internal certificate is specified, the information in this property is not useful to the receiving application.

For information on using an external certificate, see Authenticating Messages Using an External Certificate.

For information on using an internal certificate, see Authenticating Messages Using an Internal Certificate.

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.

See Also

MQGetSecurityContext, MQReceiveMessage, PROPID_M_SECURITY_CONTEXT, PROPID_M_SENDER_CERT_LEN