NegotiateStream.RemoteIdentity プロパティ

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

NegotiateStream.RemoteIdentity プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

この認証されたストリームを共有するリモート側の ID に関する情報を取得します。

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

Visual Basic (宣言)

Public Overridable ReadOnly
 Property RemoteIdentity As IIdentity

Visual Basic (使用法)

Dim instance As NegotiateStream
Dim value As IIdentity

value = instance.RemoteIdentity

C#

public virtual IIdentity RemoteIdentity { get;
 }

C++

public:
virtual property IIdentity^ RemoteIdentity {
    IIdentity^ get ();
}

J#

/** @property */
public IIdentity get_RemoteIdentity ()

JScript

public function get RemoteIdentity
 () : IIdentity

プロパティ値
リモート エンドポイントの ID を示す IIdentity オブジェクト。

例外

例外の種類	条件
InvalidOperationException	認証に失敗したか、認証が行われていません。

解説

クライアントからアクセスされると、このプロパティは、サーバーのサービス プリンシパル名 (SPN: Service Principal Name) と使用される認証プロトコルを含む GenericIdentity を返します。サーバーからアクセスされると、このプロパティは、クライアントを示す WindowsIdentity を返します。WindowsIdentity が使用できない場合、クライアント情報は GenericIdentity でサーバーに返されます。

使用例

このプロパティの値を表示する方法については、次のコード例を参照してください。

C#

    public static void EndAuthenticateCallback
 (IAsyncResult ar)
    {
        // Get the saved data.
        ClientState cState = (ClientState) ar.AsyncState;
        TcpClient clientRequest = cState.Client;
        NegotiateStream authStream = (NegotiateStream) cState.AuthenticatedStream;
        Console.WriteLine("Ending authentication.");
        // Any exceptions that occurred during authentication are
        // thrown by the EndAuthenticateAsServer method.
        try 
        {
            // This call blocks until the authentication is complete.
            authStream.EndAuthenticateAsServer(ar);
        }
        catch (AuthenticationException e)
        {
            Console.WriteLine(e);
            Console.WriteLine("Authentication failed - closing connection.");
            cState.Waiter.Set();
            return;
        }
        catch (Exception e)
        {
            Console.WriteLine(e);
            Console.WriteLine("Closing connection.");
            cState.Waiter.Set();
            return;
        }
        // Display properties of the authenticated client.
        IIdentity id = authStream.RemoteIdentity;
        Console.WriteLine("{0} was authenticated using {1}.",
 
            id.Name, 
            id.AuthenticationType
            );
        cState.Waiter.Set();

}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
NegotiateStream クラス
NegotiateStream メンバ
System.Net.Security 名前空間