Message.DestinationSymmetricKey Eigenschaft

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

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, set

Public Property DestinationSymmetricKey As Byte()

Eigenschaftswert

Byte[]

Ein Bytearray, das den zur Verschlüsselung der Meldung verwendeten symmetrischen Zielschlüssel angibt. Der Standardwert ist ein Array der Länge 0.

Attribute

MessagingDescriptionAttribute

Ausnahmen

InvalidOperationException

Die DestinationSymmetricKey-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.

ArgumentException

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.

Weitere Informationen

• ConnectorType
• UseEncryption