MSMQMessage.AuthenticationProviderName

  • Article

 

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 AuthenticationProviderName property of the MSMQMessage object specifies the name of the cryptographic provider used to generate the digital signature attached to the message.

Data type: String
Run-time access: Read/write 
Property AuthenticationProviderName As String

Property Value

A String specifying the provider name. For MSMQ 1.0 and MSMQ 2.0, the only supported string is "Microsoft Base Cryptographic Provider, v1.0". For MSMQ 3.0, "Microsoft Enhanced Cryptographic Provider, v1.0" is also supported. In all cases, the default is the name of the base provider.

Remarks

The AuthenticationProviderName property is typically used when working with foreign queues. In these cases, the name and type (MSMQMessage.AuthenticationProviderType) of the cryptographic provider are required to validate the digital signatures attached to messages sent to a foreign queue or received from a foreign messaging system. For more information on exchanging messages with foreign messaging systems, see Connector Services.

When sending messages, always set AuthenticationProviderName and MSMQMessage.ConnectorTypeGuid together. AuthenticationProviderName is ignored if MSMQMessage.ConnectorTypeGuid is not also set when the message is sent.

The AuthenticationProviderName 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.

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

Equivalent API Function Property

With API function calls, the equivalent property is PROPID_M_PROV_NAME.

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
PROPID_M_PROV_NAME
MSMQMessage.AuthenticationProviderType