Message.DestinationSymmetricKey-Eigenschaft
Ruft den symmetrischen Schlüssel für Meldungen ab, die in einer Anwendung oder für die Übermittlung an fremde Warteschlangen verschlüsselt werden.
Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)
Syntax
'Declaration
Public Property DestinationSymmetricKey As Byte()
'Usage
Dim instance As Message
Dim value As Byte()
value = instance.DestinationSymmetricKey
instance.DestinationSymmetricKey = value
public byte[] DestinationSymmetricKey { get; set; }
public:
property array<unsigned char>^ DestinationSymmetricKey {
array<unsigned char>^ get ();
void set (array<unsigned char>^ value);
}
/** @property */
public byte[] get_DestinationSymmetricKey ()
/** @property */
public void set_DestinationSymmetricKey (byte[] value)
public function get DestinationSymmetricKey () : byte[]
public function set DestinationSymmetricKey (value : byte[])
Eigenschaftenwert
Ein Bytearray, das den zur Verschlüsselung der Meldung verwendeten symmetrischen Zielschlüssel angibt. Der Standardwert ist ein Array der Länge 0.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Die DestinationSymmetricKey-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert. |
|
Der DestinationSymmetricKey ist NULL (Nothing in Visual Basic). |
Hinweise
In zwei Fällen muss die DestinationSymmetricKey-Eigenschaft verwendet werden. Es sollen Meldungen statt in Message Queuing in Ihrer Anwendung verschlüsselt werden. Weiterhin müssen Sie die Eigenschaft festlegen, wenn eine verschlüsselte Meldung an ein anderes Queuing-System als Message Queuing gesendet werden soll.
Vor dem Festlegen der Eigenschaft müssen Sie den symmetrischen Schlüssel mit dem öffentlichen Schlüssel des empfangenden Warteschlangen-Managers verschlüsseln. Bei einer von der Anwendung verschlüsselten Meldung entschlüsselt der empfangende Warteschlangen-Manager die Meldung mit dem symmetrischen Schlüssel, bevor er sie an die Zielwarteschlange weiterleitet.
Beim Senden an eine fremde Warteschlange wird die Meldung zuerst von der entsprechenden Connectoranwendung empfangen, die die verschlüsselte Meldung mit dem angefügten symmetrischen Schlüssel an die empfangende Anwendung weiterleitet. Für die Entschlüsselung der Meldung mit dem symmetrischen Schlüssel ist die empfangende Anwendung zuständig.
Wenn Sie die DestinationSymmetricKey-Eigenschaft festlegen, müssen Sie ebenfalls die ConnectorType-Eigenschaft festlegen. Beim Senden einer Meldung ignoriert Message Queuing die DestinationSymmetricKey-Eigenschaft, wenn die ConnectorType-Eigenschaft nicht festgelegt wurde.
Die maximale Größe des Arrays für die DestinationSymmetricKey-Eigenschaft ist 256.
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
Message-Klasse
Message-Member
System.Messaging-Namespace
Message.ConnectorType-Eigenschaft
UseEncryption