Message.DestinationSymmetricKey Właściwość

Definicja

Przestrzeń nazw:

System.Messaging

Zestaw:

System.Messaging.dll

Pobiera lub ustawia klucz symetryczny używany do szyfrowania komunikatów lub komunikatów zaszyfrowanych przez aplikację wysyłanych do obcych kolejek.

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

Wartość właściwości

Byte[]

Tablica wartości bajtów, która określa docelowy klucz symetryczny używany do szyfrowania komunikatu. Wartość domyślna to tablica o zerowej długości.

Atrybuty

MessagingDescriptionAttribute

Wyjątki

InvalidOperationException

Kolejka komunikatów jest filtrowana w celu zignorowania DestinationSymmetricKey właściwości.

ArgumentException

Element DestinationSymmetricKey to null.

Uwagi

Dwa scenariusze wymagają użycia DestinationSymmetricKey właściwości. Pierwszy to, gdy aplikacja, a nie kolejkowanie komunikatów, szyfruje komunikat. Drugi jest wtedy, gdy wysyłasz zaszyfrowany komunikat do systemu kolejkowania innego niż kolejkowanie komunikatów.

Przed ustawieniem tej właściwości należy zaszyfrować klucz symetryczny przy użyciu klucza publicznego menedżera kolejki odbierającego. Podczas wysyłania komunikatu zaszyfrowanego przez aplikację menedżer kolejki odbierającego używa klucza symetrycznego do odszyfrowania komunikatu przed wysłaniem go do kolejki docelowej.

Jeśli wyślesz komunikat do obcej kolejki, komunikat zostanie najpierw odebrany przez odpowiednią aplikację łącznika, która przekazuje zaszyfrowany komunikat z dołączonym kluczem symetrycznym do aplikacji odbieranej. Następnie odpowiedzialność aplikacji odbieranej za odszyfrowywanie komunikatu przy użyciu klucza symetrycznego.

Po ustawieniu DestinationSymmetricKey właściwości należy również ustawić ConnectorType właściwość . Po wysłaniu komunikatu kolejkowanie komunikatów ignoruje DestinationSymmetricKey właściwość , jeśli ConnectorType właściwość nie jest również ustawiona.

Właściwość DestinationSymmetricKey ma maksymalny rozmiar tablicy 256.

Zobacz też

• ConnectorType
• UseEncryption