Message.DestinationSymmetricKey 屬性

  • 參考

定義

命名空間:
System.Messaging
組件:
System.Messaging.dll

取得或設定用來為應用程式加密訊息或傳送至外部佇列的訊息加密的對稱金鑰。

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

屬性值

Byte[]

位元組值陣列，指定用來加密訊息的目的端對稱金鑰。 預設值是長度為零的陣列。

屬性
MessagingDescriptionAttribute

例外狀況

InvalidOperationException

篩選訊息佇列以忽略 DestinationSymmetricKey 屬性。

ArgumentException

DestinationSymmetricKey 為 null。

備註

兩個案例會要求您使用 DestinationSymmetricKey 屬性。 第一個是您的應用程式而不是消息佇列時，會加密訊息。 第二個是當您將加密的訊息傳送至消息佇列以外的佇列系統時。

設定此屬性之前，您必須使用接收佇列管理員的公鑰來加密對稱密鑰。 當您傳送應用程式加密的訊息時，接收佇列管理員會先使用對稱密鑰解密訊息，再將訊息傳送至目的地佇列。

如果您將訊息傳送至外部佇列，則訊息會先由適當的連接器應用程式接收，此應用程式會將具有附加對稱密鑰的加密訊息轉送至接收應用程式。 接著，接收應用程式會負責使用對稱密鑰解密訊息。

當您設定 DestinationSymmetricKey 屬性時，也必須設定 ConnectorType 屬性。 傳送訊息時，如果ConnectorType屬性未設定，DestinationSymmetricKey消息佇列就會忽略 屬性。

屬性 DestinationSymmetricKey 的陣列大小上限為256。

適用於

另請參閱