WindowsIdentity コンストラクター

public:
 WindowsIdentity(IntPtr userToken);

public WindowsIdentity(IntPtr userToken);

new System.Security.Principal.WindowsIdentity : nativeint -> System.Security.Principal.WindowsIdentity

Public Sub New (userToken As IntPtr)

パラメーター

例外

注釈

次の表に、 WindowsIdentityのインスタンスの初期プロパティ値を示します。

protected:
 WindowsIdentity(System::Security::Principal::WindowsIdentity ^ identity);

protected WindowsIdentity(System.Security.Principal.WindowsIdentity identity);

new System.Security.Principal.WindowsIdentity : System.Security.Principal.WindowsIdentity -> System.Security.Principal.WindowsIdentity

Protected Sub New (identity As WindowsIdentity)

パラメーター

public:
 WindowsIdentity(System::String ^ sUserPrincipalName);

public WindowsIdentity(string sUserPrincipalName);

new System.Security.Principal.WindowsIdentity : string -> System.Security.Principal.WindowsIdentity

Public Sub New (sUserPrincipalName As String)

パラメーター

例外

注釈

UPN には、 ユーザー名@ドメイン名.com、つまりメール アドレスという形式があります。 sUserPrincipalNameで識別される UPN は、Windows API LsaLogonUser関数を使用してそのユーザーのトークンを取得するために使用されます。 次に、そのトークンはユーザーを識別するために使用されます。 指定された UPN を使用してログオンできないため、例外が返される可能性があります。

public:
 WindowsIdentity(IntPtr userToken, System::String ^ type);

public WindowsIdentity(IntPtr userToken, string type);

new System.Security.Principal.WindowsIdentity : nativeint * string -> System.Security.Principal.WindowsIdentity

Public Sub New (userToken As IntPtr, type As String)

パラメーター

例外

例

次のコードは、 WindowsIdentity コンストラクターを使用して、指定した Windows アカウント トークンと指定した認証の種類で表されるユーザーの WindowsIdentity クラスの新しいインスタンスを作成する方法を示しています。 このコード例は、 WindowsIdentity クラスに提供されるより大きな例の一部です。

void IntPtrStringConstructor( IntPtr logonToken )
{
   
   // Construct a WindowsIdentity object using the input account token 
   // and the specified authentication type.
   String^ authenticationType = "WindowsAuthentication";
   WindowsIdentity^ windowsIdentity = gcnew WindowsIdentity( logonToken,authenticationType );
   
   Console::WriteLine( "Created a Windows identity object named {0}.", windowsIdentity->Name );
}

private static void IntPtrStringConstructor(IntPtr logonToken)
{
    // Construct a WindowsIdentity object using the input account token 
    // and the specified authentication type.
    string authenticationType = "WindowsAuthentication";
    WindowsIdentity windowsIdentity =
                    new WindowsIdentity(logonToken, authenticationType);

    Console.WriteLine("Created a Windows identity object named " +
        windowsIdentity.Name + ".");
}

Private Sub IntPtrStringConstructor(ByVal logonToken As IntPtr)
    ' Construct a WindowsIdentity object using the input account token 
    ' and the specified authentication type
    Dim authenticationType = "WindowsAuthentication"
    Dim windowsIdentity As _
        New WindowsIdentity(logonToken, authenticationType)

    WriteLine("Created a Windows identity object named " + _
        windowsIdentity.Name + ".")
End Sub

注釈

次の表に、 WindowsIdentityのインスタンスの初期プロパティ値を示します。

type パラメーターの値は、AuthenticationType パラメーターの設定に使用されます。 typeがnullされている場合、セキュリティ システムは、Windows Vista 以降のバージョンの Windows オペレーティング システムでNegotiateし、以前のバージョンの Windows オペレーティング システムでKerberosするようにAuthenticationTypeを設定します。 セキュリティ システムでは、この値は使用されません。これは情報提供のみを目的としています。

public:
 WindowsIdentity(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public WindowsIdentity(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

public WindowsIdentity(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Principal.WindowsIdentity : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Principal.WindowsIdentity

new System.Security.Principal.WindowsIdentity : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Principal.WindowsIdentity

Public Sub New (info As SerializationInfo, context As StreamingContext)

パラメーター

属性

ObsoleteAttribute

例外

注釈

public:
 WindowsIdentity(System::String ^ sUserPrincipalName, System::String ^ type);

public WindowsIdentity(string sUserPrincipalName, string type);

new System.Security.Principal.WindowsIdentity : string * string -> System.Security.Principal.WindowsIdentity

Public Sub New (sUserPrincipalName As String, type As String)

パラメーター

例外

注釈

type パラメーターの値は、AuthenticationType パラメーターの設定に使用されます。 typeがnullされている場合、セキュリティ システムは、Windows Vista 以降のバージョンの Windows オペレーティング システムでNegotiateし、以前のバージョンの Windows オペレーティング システムでKerberosするようにAuthenticationTypeを設定します。 セキュリティ システムでは、この値は使用されません。これは情報提供のみを目的としています。

sUserPrincipalNameで識別される UPN は、Windows API LsaLogonUser関数を使用してそのユーザーのトークンを取得するために使用されます。 次に、そのトークンはユーザーを識別するために使用されます。 指定された UPN を使用してログオンできないため、例外が返される可能性があります。

public:
 WindowsIdentity(IntPtr userToken, System::String ^ type, System::Security::Principal::WindowsAccountType acctType);

public WindowsIdentity(IntPtr userToken, string type, System.Security.Principal.WindowsAccountType acctType);

new System.Security.Principal.WindowsIdentity : nativeint * string * System.Security.Principal.WindowsAccountType -> System.Security.Principal.WindowsIdentity

Public Sub New (userToken As IntPtr, type As String, acctType As WindowsAccountType)

パラメーター

例外

例

次のコードは、 WindowsIdentity コンストラクターを使用して、指定した Windows アカウント トークン、指定した認証の種類、および指定した Windows アカウントの種類で表されるユーザーの WindowsIdentity クラスの新しいインスタンスを作成する方法を示しています。 このコード例は、 WindowsIdentity クラスに提供されるより大きな例の一部です。

void IntPtrStringTypeConstructor( IntPtr logonToken )
{
   
   // Construct a WindowsIdentity object using the input account token,
   // and the specified authentication type and Windows account type.
   String^ authenticationType = "WindowsAuthentication";
   WindowsAccountType guestAccount = WindowsAccountType::Guest;
   WindowsIdentity^ windowsIdentity = gcnew WindowsIdentity( logonToken,authenticationType,guestAccount );
   
   Console::WriteLine( "Created a Windows identity object named {0}.", windowsIdentity->Name );
}

private static void IntPtrStringTypeConstructor(IntPtr logonToken)
{
    // Construct a WindowsIdentity object using the input account token,
    // and the specified authentication type, and Windows account type.
    string authenticationType = "WindowsAuthentication";
    WindowsAccountType guestAccount = WindowsAccountType.Guest;
    WindowsIdentity windowsIdentity =
        new WindowsIdentity(logonToken, authenticationType, guestAccount);

    Console.WriteLine("Created a Windows identity object named " +
        windowsIdentity.Name + ".");
}

Private Sub IntPtrStringTypeConstructor(ByVal logonToken As IntPtr)
    ' Construct a WindowsIdentity object using the input account token,
    ' and the specified authentication type and Windows account type.
    Dim authenticationType As String = "WindowsAuthentication"
    Dim guestAccount As WindowsAccountType = WindowsAccountType.Guest
    Dim windowsIdentity As _
        New WindowsIdentity(logonToken, authenticationType, guestAccount)

    WriteLine("Created a Windows identity object named " + _
        windowsIdentity.Name + ".")
End Sub

注釈

次の表に、 WindowsIdentityのインスタンスの初期プロパティ値を示します。

type パラメーターの値は、AuthenticationType パラメーターの設定に使用されます。 typeがnullされている場合、セキュリティ システムは、Windows Vista 以降のバージョンの Windows オペレーティング システムでNegotiateし、以前のバージョンの Windows オペレーティング システムでKerberosするようにAuthenticationTypeを設定します。 セキュリティ システムでは、この値は使用されません。これは情報提供のみを目的としています。

public:
 WindowsIdentity(IntPtr userToken, System::String ^ type, System::Security::Principal::WindowsAccountType acctType, bool isAuthenticated);

public WindowsIdentity(IntPtr userToken, string type, System.Security.Principal.WindowsAccountType acctType, bool isAuthenticated);

new System.Security.Principal.WindowsIdentity : nativeint * string * System.Security.Principal.WindowsAccountType * bool -> System.Security.Principal.WindowsIdentity

Public Sub New (userToken As IntPtr, type As String, acctType As WindowsAccountType, isAuthenticated As Boolean)

パラメーター

例外

例

次のコードは、 WindowsIdentity コンストラクターを使用して、指定した Windows アカウント トークン、指定した認証の種類、指定した Windows アカウントの種類、および指定した認証状態で表されるユーザーの WindowsIdentity クラスの新しいインスタンスを作成する方法を示しています。 このコード例は、 WindowsIdentity クラスに提供されるより大きな例の一部です。

void IntPrtStringTypeBoolConstructor( IntPtr logonToken )
{
   
   // Construct a WindowsIdentity object using the input account token,
   // and the specified authentication type, Windows account type, and
   // authentication flag.
   String^ authenticationType = "WindowsAuthentication";
   WindowsAccountType guestAccount = WindowsAccountType::Guest;
   bool isAuthenticated = true;
   WindowsIdentity^ windowsIdentity = gcnew WindowsIdentity( logonToken,authenticationType,guestAccount,isAuthenticated );
   
   Console::WriteLine( "Created a Windows identity object named {0}.", windowsIdentity->Name );
}

private static void IntPrtStringTypeBoolConstructor(IntPtr logonToken)
{
    // Construct a WindowsIdentity object using the input account token,
    // and the specified authentication type, Windows account type, and
    // authentication flag.
    string authenticationType = "WindowsAuthentication";
    WindowsAccountType guestAccount = WindowsAccountType.Guest;
    bool isAuthenticated = true;
    WindowsIdentity windowsIdentity = new WindowsIdentity(
        logonToken, authenticationType, guestAccount, isAuthenticated);

    Console.WriteLine("Created a Windows identity object named " +
        windowsIdentity.Name + ".");
}

Private Sub IntPrtStringTypeBoolConstructor(ByVal logonToken As IntPtr)
    ' Construct a WindowsIdentity object using the input account token,
    ' and the specified authentication type, Windows account type, and
    ' authentication flag.
    Dim authenticationType As String = "WindowsAuthentication"
    Dim guestAccount As WindowsAccountType = WindowsAccountType.Guest
    Dim isAuthenticated As Boolean = True
    Dim windowsIdentity As New WindowsIdentity( _
        logonToken, authenticationType, guestAccount, isAuthenticated)

    WriteLine("Created a Windows identity object named " + _
        windowsIdentity.Name + ".")
End Sub

注釈

type パラメーターの値は、AuthenticationType パラメーターの設定に使用されます。 typeがnullされている場合、セキュリティ システムは、Windows Vista 以降のバージョンの Windows オペレーティング システムでNegotiateし、以前のバージョンの Windows オペレーティング システムでKerberosするようにAuthenticationTypeを設定します。 セキュリティ システムでは、この値は使用されません。これは情報提供のみを目的としています。

Windows API LogonUser関数などのアンマネージ コードを呼び出すことで、userTokenによって表されるトークンを取得できます。 Windows API CloseHandle関数を呼び出して、常にuserTokenを解放します。 アンマネージ コードの呼び出しの詳細については、「アンマネージ DLL 関数の使用」を参照してください。