Message.DestinationSymmetricKey Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den symmetrischen Schlüssel für Meldungen ab, die in einer Anwendung oder für die Übermittlung an fremde Warteschlangen verschlüsselt werden.
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, setPublic Property DestinationSymmetricKey As Byte()Eigenschaftswert
Ein Bytearray, das den zur Verschlüsselung der Meldung verwendeten symmetrischen Zielschlüssel angibt. Der Standardwert ist ein Array der Länge 0.
- Attribute
Ausnahmen
Die DestinationSymmetricKey-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.
DestinationSymmetricKey ist null.
Hinweise
In zwei Szenarien müssen Sie die DestinationSymmetricKey -Eigenschaft verwenden. Die erste ist, wenn Ihre Anwendung anstelle von Message Queuing eine Nachricht verschlüsselt. Die zweite ist, wenn Sie eine verschlüsselte Nachricht an ein anderes Warteschlangensystem als Message Queuing senden.
Bevor Sie diese Eigenschaft festlegen, müssen Sie den symmetrischen Schlüssel mit dem öffentlichen Schlüssel des empfangenden Warteschlangen-Managers verschlüsseln. Wenn Sie eine anwendungsverschlüsselte Nachricht senden, verwendet der empfangende Warteschlangen-Manager den symmetrischen Schlüssel, um die Nachricht zu entschlüsseln, bevor sie an die Zielwarteschlange gesendet wird.
Wenn Sie eine Nachricht an eine fremde Warteschlange senden, wird die Nachricht zuerst von der entsprechenden Connectoranwendung empfangen, die die verschlüsselte Nachricht mit dem angefügten symmetrischen Schlüssel an die empfangende Anwendung weiterleitet. Es liegt dann in der Verantwortung der empfangenden Anwendung, die Nachricht mithilfe des symmetrischen Schlüssels zu entschlüsseln.
Wenn Sie die DestinationSymmetricKey -Eigenschaft festlegen, müssen Sie auch die ConnectorType -Eigenschaft festlegen. Wenn die Nachricht gesendet wird, ignoriert Message Queuing die DestinationSymmetricKey Eigenschaft, wenn die ConnectorType Eigenschaft nicht auch festgelegt ist.
Die DestinationSymmetricKey Eigenschaft hat eine maximale Arraygröße von 256.
