MessageQueue.Authenticate プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
キューが認証済みメッセージだけを受け入れるかどうかを示す値を取得または設定します。
public:
property bool Authenticate { bool get(); void set(bool value); };[System.Messaging.MessagingDescription("MQ_Authenticate")]
public bool Authenticate { get; set; }[<System.Messaging.MessagingDescription("MQ_Authenticate")>]
member this.Authenticate : bool with get, setPublic Property Authenticate As Booleanプロパティ値
キューが認証済みメッセージだけを受け入れる場合は true。それ以外の場合は false。 既定値は、false です。
- 属性
例外
メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。
例
次のコード例では、メッセージ キュー Authenticate のプロパティの値を取得および設定します。
// Set the queue's Authenticate property value.
queue.Authenticate = true;
// Display the new value of the queue's Authenticate property.
Console.WriteLine("MessageQueue.Authenticate: {0}", queue.Authenticate);
注釈
メッセージ認証は、メッセージの整合性を確保し、メッセージを送信したユーザーを確認する方法を提供します。 認証を要求するために、送信側アプリケーションはメッセージの認証レベルを設定します。
にtrue設定Authenticateすると、このMessageQueueインスタンスだけでなく、サーバー上のキューへのアクセスを制限します。 同じメッセージ キュー キューに対して動作するすべてのクライアントが影響を受けます。
認証されたメッセージのみを受け入れるキューは、認証されていないメッセージを拒否します。 メッセージ拒否の通知を要求するために、送信アプリケーションはメッセージのプロパティを AcknowledgeType 設定できます。 メッセージ拒否の他の兆候は存在しないため、配信不能キューへの送信を要求しない限り、送信側アプリケーションはメッセージを失う可能性があります。
次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。
| ワークグループ モード | 利用可能 |
|---|---|
| ローカル コンピューター | はい |
| ローカル コンピューターと直接形式名 | はい |
| リモート コンピューター | いいえ |
| リモート コンピューターと直接形式名 | いいえ |