MessageQueue.Authenticate プロパティ

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

MessageQueue.Authenticate プロパティ

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

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

Visual Basic (宣言)

Public Property Authenticate As
 Boolean

Visual Basic (使用法)

Dim instance As MessageQueue
Dim value As Boolean

value = instance.Authenticate

instance.Authenticate = value

C#

public bool Authenticate { get;
 set; }

C++

public:
property bool Authenticate {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_Authenticate ()

/** @property */
public void set_Authenticate (boolean value)

JScript

public function get Authenticate
 () : boolean

public function set Authenticate
 (value : boolean)

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

例外

例外の種類	条件
MessageQueueException	メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。

解説

メッセージの認証によってメッセージの整合性が保証され、メッセージの送信元が確認されます。認証を要求するには、送信元アプリケーションでメッセージの認証レベルを設定します。

Authenticate を true に設定すると、この MessageQueue インスタンスへのアクセスだけではなく、サーバーのキューへのアクセスが制限されます。同じメッセージ キューのキューで動作するすべてのクライアントが影響を受けます。

認証済みメッセージだけを受け入れるキューは、認証されていないメッセージを拒否します。メッセージが拒否された場合に通知を要求するには、送信元アプリケーションでメッセージの AcknowledgeType プロパティを設定します。メッセージが拒否されたことを示す他の通知が存在しないため、配信不能キューに送信するように要求しない限り、送信元アプリケーションはメッセージを失うことがあります。

このプロパティが各種のワークグループ モードで使用できるかどうかを次の表に示します。

ワークグループ モード	使用可否
ローカル コンピュータ	○
ローカル コンピュータと直接書式名	○
リモート コンピュータ	×
リモート コンピュータと直接書式名	×

使用例

メッセージ キューの Authenticate プロパティに対し、値の取得と設定を行うコード例を次に示します。

C#

// 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);

J#

// Set the queue's Authenticate property value.
queue.set_Authenticate(true);
// Display the new value of the queue's Authenticate property.
Console.WriteLine("MessageQueue.Authenticate: {0}", 
    System.Convert.ToString(queue.get_Authenticate()));

.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

参照

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