Message.DestinationSymmetricKey Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает симметричный ключ, применяемый для шифрования сообщений, шифруемых приложением, или сообщений, отправляемых во внешние очереди.
public:
property cli::array <System::Byte> ^ DestinationSymmetricKey { cli::array <System::Byte> ^ get(); void set(cli::array <System::Byte> ^ value); };
[System.Messaging.MessagingDescription("MsgDestinationSymmetricKey")]
public byte[] DestinationSymmetricKey { get; set; }
[<System.Messaging.MessagingDescription("MsgDestinationSymmetricKey")>]
member this.DestinationSymmetricKey : byte[] with get, set
Public Property DestinationSymmetricKey As Byte()
Значение свойства
Массив байтовых значений, задающий целевой симметричный ключ, используемый для шифрования сообщения. По умолчанию задан массив нулевой длины.
- Атрибуты
Исключения
Очередь сообщений фильтруется, чтобы не учитывать свойство DestinationSymmetricKey.
Значение параметра DestinationSymmetricKey — null
.
Комментарии
В двух сценариях требуется использовать DestinationSymmetricKey свойство . Во-первых, приложение, а не очередь сообщений, шифрует сообщение. Второй — отправка зашифрованного сообщения в систему очередей, отличной от очереди сообщений.
Прежде чем задать это свойство, необходимо зашифровать симметричный ключ с помощью открытого ключа принимающего диспетчера очередей. При отправке сообщения, зашифрованного приложением, получающий диспетчер очередей использует симметричный ключ для расшифровки сообщения перед его отправкой в целевую очередь.
При отправке сообщения во внешнюю очередь сообщение сначала получает соответствующее приложение соединителя, которое пересылает зашифрованное сообщение с присоединенным симметричным ключом в принимающее приложение. Затем принимающее приложение отвечает за расшифровку сообщения с помощью симметричного ключа.
При установке DestinationSymmetricKey свойства необходимо также задать ConnectorType свойство . При отправке сообщения очередь сообщений игнорирует DestinationSymmetricKey свойство , если ConnectorType свойство также не задано.
Свойство DestinationSymmetricKey имеет максимальный размер массива 256.