Expand Minimize

MSMQMessage.ConnectorTypeGuid

(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

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.

ms704938.note(en-us,VS.85).gifNote
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

ms704938.note(en-us,VS.85).gifNote
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

Message Queuing 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

Show:
© 2015 Microsoft