This documentation is archived and is not being maintained.

Message.AuthenticationProviderName Property

Gets or sets the name of the cryptographic provider used to generate the digital signature of the message.

[Visual Basic]
Public Property AuthenticationProviderName As String
[C#]
public string AuthenticationProviderName {get; set;}
[C++]
public: __property String* get_AuthenticationProviderName();
public: __property void set_AuthenticationProviderName(String*);
[JScript]
public function get AuthenticationProviderName() : String;
public function set AuthenticationProviderName(String);

Property Value

The name of the cryptographic provider used to generate the digital signature of the message. The default is Microsoft Base Cryptographic Provider, Ver. 1.0.

Exceptions

Exception Type Condition
InvalidOperationException The AuthenticationProviderName property could not be set.

-or-

The message queue is filtered to ignore the AuthenticationProviderName property.

ArgumentException The AuthenticationProviderName was set to a null reference (Nothing in Visual Basic).

Remarks

You typically use the AuthenticationProviderName when working with foreign queues. Message Queuing requires the authentication provider name and authentication provider type of the cryptographic provider (authentication provider) to validate the digital signatures of both messages sent to a foreign queue and messages passed to Message Queuing from a foreign queue.

When sending a message, always set the AuthenticationProviderName and ConnectorType properties together. When the message is sent, Message Queuing ignores the authentication provider name if the connector type is not also set.

The AuthenticationProviderName property cannot be a null reference (Nothing in Visual Basic), but it can be an empty string ("").

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

.NET Framework Security: 

See Also

Message Class | Message Members | System.Messaging Namespace | Authenticated | UseAuthentication | ConnectorType | AuthenticationProviderType | Authenticate

Show: