Expand Minimize

PROPID_M_CONNECTOR_TYPE

The PROPID_M_CONNECTOR_TYPE property specifies a connector application identifier. This property is set when some message properties that are typically set by Message Queuing were set by the sending application.

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

Property ID

PROPID_M_CONNECTOR_TYPE

Type Indicator

VT_CLSID

MQPROPVARIANT Field

puuid

Property Value

Pointer to a connector application identifier.

Remarks

PROPID_M_CONNECTOR_TYPE is required whenever an application sets a message property that is typically set by Message Queuing. 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 PROPID_M_CONNECTOR_TYPE when it sets any of the following properties. If PROPID_M_CONNECTOR_TYPE is not set, these properties will be ignored:

PROPID_M_PROV_NAME

PROPID_M_PROV_TYPE

PROPID_M_DEST_SYMM_KEY

PROPID_M_CLASS

PROPID_M_SIGNATURE

PROPID_M_SENDERID

To specify a connector type, include PROPID_M_CONNECTOR_TYPE in the MQMSGPROPS structure and then call MQSendMessage.

To retrieve the connector type specified by the sending application, include PROPID_M_CONNECTOR_TYPE in the MQMSGPROPS structure, then call MQReceiveMessage or MQReceiveMessageByLookupId and examine the returned values.

ms703940.note(en-us,VS.85).gifNote
Message Queuing does not support this property in SRMP messages.

Equivalent COM Property

With COM components, the equivalent property for specifying and retrieving a connector application identifier is MSMQMessage.ConnectorTypeGuid.

For information on See

Connector applications

Message Queuing Connector Services

Sending a symmetric key when encrypting messages

Application-Encrypted Messages

Example Code

The following code fragment shows how PROPID_M_CONNECTOR_TYPE is added to arrays that can be used to initialize an MQMSGPROPS structure.

CLSID guidConnectorType = 0;                // Or the value being set
aMsgPropId[i] = PROPID_M_CONNECTOR_TYPE;    // Property ID
aMsgPropVar[i].vt = VT_CLSID;               // Type indicator
aMsgPropVar[i].puuid = &guidConnectorType;
i++;

See Also

Show:
© 2014 Microsoft