Message.DestinationSymmetricKey Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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
Exceptions
La file d'attente des messages est filtrée pour ignorer la propriété DestinationSymmetricKey.
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.