Message.DestinationSymmetricKey Propriété

Définition

Espace de noms:

System.Messaging

Assembly:

System.Messaging.dll

Obtient ou définit la clé symétrique utilisée pour chiffrer les messages chiffrés par l'application ou les messages envoyés aux files d'attente externes.

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

Valeur de propriété

Byte[]

Un tableau des valeurs d'octets qui spécifie la clé symétrique de destination utilisée pour chiffrer le message. La valeur par défaut est un tableau de longueur zéro.

Attributs

MessagingDescriptionAttribute

Exceptions

InvalidOperationException

La file d'attente des messages est filtrée pour ignorer la propriété DestinationSymmetricKey.

ArgumentException

DestinationSymmetricKey a la valeur null.

Remarques

Deux scénarios nécessitent l’utilisation de la DestinationSymmetricKey propriété . La première est lorsque votre application, plutôt que Message Queuing, chiffre un message. La deuxième est lorsque vous envoyez un message chiffré à un système de mise en file d’attente autre que Message Queuing.

Avant de définir cette propriété, vous devez chiffrer la clé symétrique avec la clé publique du gestionnaire de files d’attente de réception. Lorsque vous envoyez un message chiffré par l’application, le gestionnaire de files d’attente de réception utilise la clé symétrique pour déchiffrer le message avant de l’envoyer à sa file d’attente de destination.

Si vous envoyez un message à une file d’attente étrangère, le message est d’abord reçu par l’application connecteur appropriée, qui transfère le message chiffré avec la clé symétrique jointe à l’application de réception. Il incombe ensuite à l’application de réception de déchiffrer le message à l’aide de la clé symétrique.

Lorsque vous définissez la DestinationSymmetricKey propriété, vous devez également définir la ConnectorType propriété . Lorsque le message est envoyé, Message Queuing ignore la DestinationSymmetricKey propriété si la ConnectorType propriété n’est pas également définie.

La DestinationSymmetricKey propriété a une taille de tableau maximale de 256.

Voir aussi

• ConnectorType
• UseEncryption