Message.UseAuthentication プロパティ

メッセージが送信前に認証された (または認証される必要がある) かどうかを示す値を取得または設定します。

Public Property UseAuthentication As Boolean
[C#]
public bool UseAuthentication {get; set;}
[C++]
public: __property bool get_UseAuthentication();public: __property void set_UseAuthentication(bool);
[JScript]
public function get UseAuthentication() : Boolean;public function set UseAuthentication(Boolean);

プロパティ値

送信元アプリケーションがメッセージの認証を要求した場合は true 。それ以外の場合は false 。既定値は false です。

例外

例外の種類 条件
InvalidOperationException フィルタ処理されたメッセージ キューが、 UseAuthentication プロパティを無視します。

解説

UseAuthentication プロパティは、メッセージの認証が必要かどうかを指定します。送信元アプリケーションが認証を要求している場合、メッセージ キューはデジタル署名を作成し、メッセージの送信時にメッセージに署名するときと、受信時にメッセージを認証するときにこの署名を使います。

認証されたメッセージだけを受理するキューにメッセージが送信されたとき、 UseAuthenticationfalse に設定されていると、そのキューへの到達時にメッセージは拒否されます。

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

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

Message クラス | Message メンバ | System.Messaging 名前空間 | Authenticated | ConnectorType | AuthenticationProviderName | AuthenticationProviderType | DigitalSignature | Authenticate | AcknowledgeTypes | AttachSenderId