MSMQMessage.ConnectorTypeGuid
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
Property Value
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}
Remarks
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
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.
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
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 on | See |
|---|---|
| Connector applications | Connector Services |
| Sending a symmetric key when encrypting messages | Application-Encrypted Messages |
Requirements
Windows NT/2000/XP: Included in Windows 2000 and later.
Windows 95/98/Me: Unsupported.
Header: Declared in Mqoai.h.
Library: Use Mqoa.lib
See Also
MSMQMessage
MSMQMessage.AuthenticationProviderName
MSMQMessage.AuthenticationProviderType
MSMQMessage.DestinationSymmetricKey
MSMQMessage.MsgClass
MSMQMessage.Signature
MSMQMessage.SenderId
PROPID_M_CONNECTOR_TYPE