Message.DestinationSymmetricKey プロパティ

.NET Framework クラス ライブラリ リファレンス

Message.DestinationSymmetricKey プロパティ

アプリケーションによって暗号化されるメッセージ、または外部キューに送信されるメッセージを暗号化するために使用する対称キーを取得または設定します。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Property DestinationSymmetricKey As
 Byte()

Visual Basic (使用法)

Dim instance As Message
Dim value As Byte()

value = instance.DestinationSymmetricKey

instance.DestinationSymmetricKey = value

C#

public byte[] DestinationSymmetricKey { get;
 set; }

C++

public:
property array<unsigned char>^ DestinationSymmetricKey {
    array<unsigned char>^ get ();
    void set (array<unsigned char>^
 value);
}

J#

/** @property */
public byte[] get_DestinationSymmetricKey ()

/** @property */
public void set_DestinationSymmetricKey (byte[]
 value)

JScript

public function get DestinationSymmetricKey
 () : byte[]

public function set DestinationSymmetricKey
 (value : byte[])

プロパティ値
メッセージを暗号化するために使用される送信先対称キーを指定するバイト値配列。既定値は長さ 0 の配列です。

例外

例外の種類	条件
InvalidOperationException	フィルタ処理されたメッセージ キューが、DestinationSymmetricKey プロパティを無視します。
ArgumentException	DestinationSymmetricKey が null 参照 (Visual Basic では Nothing) です。

解説

DestinationSymmetricKey プロパティは、次の 2 つの場合に使用する必要があります。1 つは、メッセージ キューではなくアプリケーションがメッセージを暗号化するときです。もう 1 つは、暗号化されたメッセージをメッセージ キュー以外のキュー システムに送信するときです。

このプロパティを設定する前に、受信側キュー マネージャの公開キーで対称キーを暗号化する必要があります。アプリケーションによって暗号化されるメッセージを送信するときには、受信側キュー マネージャは、対称キーを使ってメッセージを解読してから送信先キューに送信します。

メッセージを外部キューに送信すると、メッセージはまず適切なコネクタ アプリケーションによって受信されます。次にコネクタ アプリケーションが、暗号化されたメッセージを、結び付けられた共通キーと共に受信側アプリケーションに転送します。対称キーの使用によるメッセージの解読は、受信側アプリケーションで行う必要があります。

DestinationSymmetricKey プロパティを設定するときには、ConnectorType プロパティも設定する必要があります。メッセージが送信されたときに、ConnectorType プロパティが設定されていないと、メッセージ キューは DestinationSymmetricKey プロパティを無視します。

DestinationSymmetricKey プロパティの最大配列サイズは 256 です。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Message クラス
Message メンバ
System.Messaging 名前空間
Message.ConnectorType プロパティ
UseEncryption