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.DigitalSignature

Gets or sets the digital signature used to authenticate the message.

[Visual Basic]
Overridable Public Property DigitalSignature As Byte ()
[C#]
public byte[] DigitalSignature {virtual get; virtual set;}
[C++]
public: __property virtual unsigned char* get_DigitalSignature();
public: __property virtual void set_DigitalSignature(unsigned char*[]);
[JScript]
public function get DigitalSignature() : Byte[];
public function set DigitalSignature(Byte[]);

Property Value

An array of type 8-bit unsigned integer which specifies the Message Queuing 1.0 digital signature used to authenticate the message. The default is a zero-length array.

Exceptions

Exception Type Condition
InvalidOperationException The message queue is filtered to not read the DigitalSignature property.
ArgumentException The DigitalSignature is a null reference (in Visual Basic Nothing).

Remarks

In most cases, the DigitalSignature is generated and set by Message Queuing when the sending application requests authentication. In these cases, only the receiving application will use this property to retrieve the digital signature attached to the message. The DigitalSignature property can only be used when running Message Queuing 2.0. It is used when authenticating messages that were sent by Message Queuing 1.0.

Note   If the sending application sent a Message Queuing 2.0 signature, this property will contain a buffer of 4 zeroed bytes.

DigitalSignature has a maximum array size of 256.

Example

See Also

Message Class | Message Members | System.Messaging Namespace | ConnectorType | UseAuthentication