PROPID_M_PROV_TYPE

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

The PROPID_M_PROV_TYPE property specifies the type of cryptographic provider used to generate the digital signature attached to the message.

Property ID

PROPID_M_PROV_TYPE

Type Indicator

VT_UI4

MQPROPVARIANT Field

ulVal

Property Value

PROV_RSA_FULL, which is the default and the only supported value.

Remarks

The PROPID_M_PROV_TYPE property is typically used when working with foreign queues. The type and name (PROPID_M_PROV_NAME) of the cryptographic provider are required to validate the digital signature of a message sent to a foreign queue or messages passed to Message Queuing from a foreign messaging system.

To specify the type of cryptographic provider, specify PROPID_M_PROV_TYPE in the MQMSGPROPS and call MQSendMessage.

To retrieve the type of cryptographic provider, specify PROPID_M_PROV_TYPE in the MQMSGPROPS structure. Then call MQReceiveMessage or MQReceiveMessageByLookupId and examine the returned value. When retrieving this property, the type indicator can be set to VT_UI4 or VT_NULL. If you set the type indicator to VT_NULL, Message Queuing automatically changes the type indicator to VT_UI4 during the function call.

Equivalent COM Property

With COM components, the equivalent property for setting and retrieving the type of cryptographic provider is MSMQMessage.AuthenticationProviderType.

Example Code

The following code fragment shows how PROPID_M_PROV_TYPE is included in the MQMSGPROPS structure for setting the cryptographic provider name and type.

To Send the Cryptographic Provider Name

aMsgPropId[i] = PROPID_M_PROV_NAME;         // Property ID  
aMsgPropVar[i].vt = VT_LPWSTR;              // Type indicator  
aMsgPropVar[i].pwszVal = wszProviderName;  
i++;  
  
aMsgPropId[i] = PROPID_M_PROV_TYPE;         // Property ID  
aMsgPropVar[i].vt = VT_UI4;                 // Type indicator  
aMsgPropVar[i].ulVal = dwProviderType;  
i++;  

See Also

Message Properties
MQMSGPROPS
MQReceiveMessage
MQReceiveMessageByLookupId
MSMQMessage.AuthenticationProviderType
PROPID_M_PROV_NAME