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.