Message.DestinationSymmetricKey Propriedade

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Obtém ou define a chave simétrica usada para criptografar mensagens criptografadas por aplicativos ou mensagens enviadas para filas externas.

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()

Valor da propriedade

Byte[]

Uma matriz de valores de bytes que especifica a chave simétrica de destino usada para criptografar a mensagem. O padrão é uma matriz de comprimento zero.

Atributos

MessagingDescriptionAttribute

Exceções

InvalidOperationException

A fila de mensagens é filtrada para ignorar a propriedade DestinationSymmetricKey.

ArgumentException

O DestinationSymmetricKey é null.

Comentários

Dois cenários exigem que você use a DestinationSymmetricKey propriedade . A primeira é quando seu aplicativo, em vez de Enfileiramento de Mensagens, criptografa uma mensagem. A segunda é quando você envia uma mensagem criptografada para um sistema de enfileiramento diferente do Enfileiramento de Mensagens.

Antes de definir essa propriedade, você deve criptografar a chave simétrica com a chave pública do gerenciador de filas de recebimento. Quando você envia uma mensagem criptografada pelo aplicativo, o gerenciador de filas de recebimento usa a chave simétrica para descriptografar a mensagem antes de enviá-la para sua fila de destino.

Se você enviar uma mensagem para uma fila estrangeira, a mensagem será recebida primeiro pelo aplicativo conector apropriado, que encaminha a mensagem criptografada com a chave simétrica anexada para o aplicativo receptor. Em seguida, é responsabilidade do aplicativo receptor descriptografar a mensagem usando a chave simétrica.

Ao definir a DestinationSymmetricKey propriedade, você também deve definir a ConnectorType propriedade . Quando a mensagem é enviada, o Enfileiramento de Mensagens ignora a DestinationSymmetricKey propriedade se a ConnectorType propriedade também não estiver definida.

A DestinationSymmetricKey propriedade tem um tamanho máximo de matriz de 256.

Confira também

• ConnectorType
• UseEncryption