Message.DigitalSignature Message.DigitalSignature Message.DigitalSignature Message.DigitalSignature Property

Определение

Получает или задает цифровую подпись, используемую службой очереди сообщений при проверке подлинности сообщения.Gets or sets the digital signature that Message Queuing uses to authenticate the message.

public:
 property cli::array <System::Byte> ^ DigitalSignature { cli::array <System::Byte> ^ get(); void set(cli::array <System::Byte> ^ value); };
[System.Messaging.MessagingDescription("MsgDigitalSignature")]
public byte[] DigitalSignature { get; set; }
member this.DigitalSignature : byte[] with get, set
Public Property DigitalSignature As Byte()

Значение свойства

Byte[]

Массив байтовых значений, задающий цифровую подпись очереди сообщений 1.0, используемую для проверки подлинности сообщения.An array of byte values that specifies the Message Queuing 1.0 digital signature used to authenticate the message. По умолчанию задан массив нулевой длины.The default is a zero-length array.

Исключения

Очередь сообщений фильтруется, чтобы не учитывать свойство DigitalSignature.The message queue is filtered to ignore the DigitalSignature property.

Значение свойства DigitalSignaturenull.The DigitalSignature property is null.

Комментарии

Служба очереди сообщений использует цифровую подпись при проверке подлинности сообщений, отправленных службой очередей сообщений версии 1,0.Message Queuing uses the digital signature when authenticating messages that were sent by Message Queuing version 1.0. В большинстве случаев очередь сообщений создает и задает DigitalSignature свойство, когда отправляющее приложение запрашивает проверку подлинности.In most cases, Message Queuing generates and sets the DigitalSignature property when the sending application requests authentication. Принимающее приложение использует это свойство для получения цифровой подписи, прикрепленной к сообщению.The receiving application uses this property to retrieve the digital signature attached to the message.

DigitalSignature Свойство можно использовать только при работе с очередью сообщений версии 2,0.You can only use the DigitalSignature property when running Message Queuing version 2.0. При запросе проверки подлинности в отправляющем приложении должны быть указаны сигнатуры очереди сообщений версии 1,0.The sending application must specify Message Queuing version 1.0 signatures when requesting authentication. Если отправляющее приложение отправляет сигнатуру очереди сообщений версии 2,0, это свойство содержит буфер из четырех байтов, каждый из которых содержит ноль.If the sending application sends a Message Queuing version 2.0 signature, this property contains a buffer of four bytes, each containing zero.

DigitalSignature Свойство вместе SenderCertificate со свойством также используется приложениями-соединителями при отправке сообщения.The DigitalSignature property, together with the SenderCertificate property, is also used by connector applications when a message is sent. В этом сценарии приложение соединителя, а не Message Queuing, создает цифровую подпись, которая основывается на сертификате пользователя, отправляющего сообщение.In this scenario, the connector application - rather than Message Queuing - generates the digital signature, which it bases on the certificate of the user sending the message.

DigitalSignature Свойство имеет максимальный размер массива, равный 256.The DigitalSignature property has a maximum array size of 256.

При задании DigitalSignature свойства необходимо также ConnectorType задать свойство.When you set the DigitalSignature property, you must also set the ConnectorType property. При отправке сообщения служба Message Queuing игнорирует это DigitalSignature свойство, ConnectorType если свойство не задано.When a message is sent, Message Queuing ignores the DigitalSignature property if the ConnectorType property is not also set.

Применяется к

Дополнительно