NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

Message.AuthenticationProviderName

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

[Visual Basic]
Overridable Public Property AuthenticationProviderName As String
[C#]
public string AuthenticationProviderName {virtual get; virtual
   set;}
[C++]
public: __property virtual String* get_AuthenticationProviderName();
public: __property virtual 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.
ArgumentException The AuthenticationProviderName was set to a null reference (in Visual Basic Nothing).

Remarks

AuthenticationProviderName provides access to the AuthenticationProviderName property of the Message Queuing application's MSMQMessage object.

The AuthenticationProviderName is typically used when working with foreign queues. The AuthenticationProviderName and AuthenticationProviderType of the cryptographic provider (authentication provider) are required to validate the digital signature of messages sent to a foreign queue or messages passed to Message Queuing from a foreign queue.

When sending messages, always set AuthenticationProviderName and ConnectorType together. The authentication provider name is ignored if the connector type is not also set when the message is sent.

AuthenticationProviderName can't be a null reference (Nothing), but it can be an empty string ("").

Example

See Also

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