MessageQueue.EncryptionRequired プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
キューが非プライベート (暗号化されていない) メッセージだけを受け入れるかどうかを示す値を取得または設定します。
public:
property System::Messaging::EncryptionRequired EncryptionRequired { System::Messaging::EncryptionRequired get(); void set(System::Messaging::EncryptionRequired value); };[System.Messaging.MessagingDescription("MQ_EncryptionRequired")]
public System.Messaging.EncryptionRequired EncryptionRequired { get; set; }[<System.Messaging.MessagingDescription("MQ_EncryptionRequired")>]
member this.EncryptionRequired : System.Messaging.EncryptionRequired with get, setPublic Property EncryptionRequired As EncryptionRequiredプロパティ値
EncryptionRequired 値のいずれか 1 つ。 既定値は、None です。
- 属性
例外
メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。
例
次のコード例では、メッセージ キュー EncryptionRequired のプロパティの値を取得および設定します。
// Set the queue's EncryptionRequired property value.
queue.EncryptionRequired = System.Messaging.EncryptionRequired.Optional;
// Display the new value of the queue's EncryptionRequired property.
Console.WriteLine("MessageQueue.EncryptionRequired: {0}",
queue.EncryptionRequired);
注釈
キューに送信されるメッセージに暗号化が必要であることを指定すると、メッセージ本文のみが暗号化されます。 他のメンバー (たとえば、プロパティ Label など SenderId ) は暗号化できません。
このプロパティを設定すると、メッセージ キュー キューが変更されます。 そのため、その他 MessageQueue のインスタンスは変更の影響を受けます。
メッセージを暗号化すると、メッセージがプライベートになります。 キューの暗号化要件を 、BodyまたはOptionalプロパティをNone適切に設定EncryptionRequiredして指定できます。 メッセージの設定は UseEncryption 、キューの暗号化要件に対応している必要があります。 メッセージが暗号化されていないがキューで指定 Bodyされている場合、またはメッセージが暗号化されていてもキューで指定 Noneされている場合、メッセージはキューによって拒否されます。 送信側アプリケーションがこのイベントで否定確認メッセージを要求した場合、メッセージ キューは、送信側アプリケーションに対するメッセージの拒否を示します。 プロパティが指定されている UseDeadLetterQueue 場合、 true暗号化に失敗したメッセージが配信不能キューに送信されます。 それ以外の場合、メッセージは失われます。
次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。
| ワークグループ モード | 利用可能 |
|---|---|
| ローカル コンピューター | はい |
| ローカル コンピューターと直接形式名 | はい |
| リモート コンピューター | いいえ |
| リモート コンピューターと直接形式名 | いいえ |