MSMQMessage.ConnectorTypeGuid

 

Updated: July 19, 2016

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

(Introduced in MSMQ 2.0.) The ConnectorTypeGuid property of the MSMQMessage object indicates that some message properties that are typically set by Message Queuing were set by the sending application.

Typically, this property is set by a connector application and applications sending application-encrypted messages.

Data type:String (GUID format)
Run-time access:Read/write
Property ConnectorTypeGuid As String  

A String representation of an application-defined GUID. For example, of the following strings, the first indicates a valid setting, and the second indicates the default GUID_NULL.

{12345678-1234-1234-1234-123456789ABC}  
{00000000-0000-0000-0000-000000000000}  

ConnectorTypeGuid is required whenever an application sets a message property that is typically set by MSMQ. It is typically used in the following two cases.

Whenever a connector application sends a message to a Message Queuing queue, the connector type property is required so that the receiving applications know how to interpret the security and acknowledgment properties of the messages.

Whenever an application sends an application-encrypted message, the connector type property is required so that the Message Queuing runtime knows to use the symmetric key provided in MSMQMessage.DestinationSymmetricKey to decrypt the message.

The sending application must set ConnectorTypeGuid when it sets any of the following properties. If ConnectorTypeGuid is not set, these properties will be ignored:

MSMQMessage.AuthenticationProviderName

MSMQMessage.AuthenticationProviderType

MSMQMessage.DestinationSymmetricKey

MSMQMessage.MsgClass

MSMQMessage.Signature

MSMQMessage.SenderId

The receiving application must explicitly specify that it wants this property when peeking at or retrieving messages. Each peek and receive method has a WantConnectorType argument that controls whether this property is retrieved with the message. By default, ConnectorTypeGuid is not retrieved with the message.

The ConnectorTypeGuid property is a string, and Message Queuing COM components ignore any characters that follow the first null character in a string without returning an error.

System_CAPS_ICON_note.jpg Note

Message Queuing does not support this property in SRMP messages.

In C++ COM applications, you must use a smart pointer to the IMSMQMessage2 or IMSMQMessage3 interface to expose the

System_CAPS_ICON_note.jpg Note

Message Queuing does not support this property in SRMP messages. property.

Equivalent API Function Property

With API function calls, the equivalent property is PROPID_M_CONNECTOR_TYPE.

For information onSee
Connector applicationsConnector Services
Sending a symmetric key when encrypting messagesApplication-Encrypted Messages

Windows NT/2000/XP: Included in Windows 2000 and later.

Windows 95/98/Me: Unsupported.

Header: Declared in Mqoai.h.

Library: Use Mqoa.lib

MSMQMessage
MSMQMessage.AuthenticationProviderName
MSMQMessage.AuthenticationProviderType
MSMQMessage.DestinationSymmetricKey
MSMQMessage.MsgClass
MSMQMessage.Signature
MSMQMessage.SenderId
PROPID_M_CONNECTOR_TYPE

Show: