MessageQueue.Authenticate プロパティ

定義

名前空間:

System.Messaging

アセンブリ:

System.Messaging.dll

キューが認証済みメッセージだけを受け入れるかどうかを示す値を取得または設定します。

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, set

Public Property Authenticate As Boolean

プロパティ値

Boolean

キューが認証済みメッセージだけを受け入れる場合は true。それ以外の場合は false。 既定値は、false です。

属性

MessagingDescriptionAttribute

例外

MessageQueueException

メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。

例

次のコード例では、メッセージ キュー 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 設定できます。 メッセージ拒否の他の兆候は存在しないため、配信不能キューへの送信を要求しない限り、送信側アプリケーションはメッセージを失う可能性があります。

次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード	利用可能
ローカル コンピューター	はい
ローカル コンピューターと直接形式の名前	はい
リモート コンピューター	いいえ
リモート コンピューターと直接形式の名前	いいえ

こちらもご覧ください

• UseDeadLetterQueue
• AcknowledgeType