Message.Authenticated プロパティ

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

Message.Authenticated プロパティ

メッセージが認証されたかどうかを示す値を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 Authenticated As Boolean

Visual Basic (使用法)

Dim instance As Message
Dim value As Boolean

value = instance.Authenticated

C#

public bool Authenticated { get;
 }

C++

public:
property bool Authenticated {
    bool get ();
}

J#

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

JScript

public function get Authenticated
 () : boolean

プロパティ値
メッセージがキューに格納されたときにメッセージの認証が要求された場合は true。それ以外の場合は false。

例外

例外の種類	条件
InvalidOperationException	メッセージは送信されていません。このプロパティは、キューから取得したメッセージでだけ読み込むことができます。 または フィルタ処理されたメッセージ キューが、Authenticated プロパティを無視します。

解説

アプリケーションだけに使用される Authenticated プロパティは、メッセージとの対話中に認証が要求されているかどうかを調べます。メッセージがキューの中にあれば、そのメッセージは認証されています。逆に、Authenticated プロパティが true の場合、受信側キュー マネージャはメッセージの受信時にそのメッセージを認証しています。

メッセージの認証に失敗したかどうかをメッセージのプロパティを参照することで判断することはできません。メッセージ キューは、キューに配信される前に認証に失敗したメッセージを破棄します。しかし、配信の失敗によってメッセージがキューに到達できなかった場合に受信確認メッセージを送信するように要求できます。

使用例

メッセージの Authenticated プロパティの値を表示するコード例を次に示します。

C#

// Display the value of the message's Authenticated property.
// To view this property value, the queue's
// MessageReadPropertyFilter.Authenticated property must be set to
// true before the message is received.
Console.WriteLine("Authentication requested for this
 message: {0}",
    orderMessage.Authenticated.ToString());

C++

// Display the value of the message's Authenticated property.
// To view this property value, the queue's
// MessageReadPropertyFilter.Authenticated property must be set to
// true before the message is received.
Console::WriteLine("Authentication requested for this
 message: {0}",
    orderMessage->Authenticated.ToString());

J#

// Display the value of the message's Authenticated property.
// To view this property value, the queue's
// MessageReadPropertyFilter.Authenticated property must be set to
// true before the message is received.
Console.WriteLine("Authentication requested for this
 message: {0}", 
    System.Convert.ToString(orderMessage.get_Authenticated()));

.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 名前空間
UseAuthentication
ConnectorType
Authenticate
DigitalSignature