WindowsIdentity Constructores

public:
 WindowsIdentity(IntPtr userToken);

public WindowsIdentity (IntPtr userToken);

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

Public Sub New (userToken As IntPtr)

Parámetros

Excepciones

Comentarios

En la tabla siguiente se muestran los valores de propiedad iniciales de una instancia de 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)

Parámetros

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)

Parámetros

Excepciones

Comentarios

Un UPN tiene el formatonombre de dominio de nombre de usuario@.com, es decir, una dirección de correo electrónico. El UPN identificado en sUserPrincipalName se usa para recuperar un token para ese usuario a través de la función de la API LsaLogonUser de Windows. A su vez, ese token se usa para identificar al usuario. Es posible que se devuelva una excepción debido a la incapacidad de iniciar sesión con el UPN proporcionado.

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)

Parámetros

Excepciones

Ejemplos

En el código siguiente se muestra el uso del WindowsIdentity constructor para crear una nueva instancia de la WindowsIdentity clase para el usuario representado por el token de cuenta de Windows especificado y el tipo de autenticación especificado. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase 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

Comentarios

En la tabla siguiente se muestran los valores de propiedad iniciales de una instancia de WindowsIdentity.

El valor del type parámetro se usa para establecer el AuthenticationType parámetro . Si type es null, el sistema de seguridad establece NegotiateAuthenticationType en en Windows Vista y versiones posteriores del sistema operativo Windows y Kerberos en versiones anteriores del sistema operativo Windows. El sistema de seguridad no utiliza este valor; es solo para uso informativo.

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}")]
public WindowsIdentity (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

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

[<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

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

Parámetros

Atributos

ObsoleteAttribute

Excepciones

Comentarios

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)

Parámetros

Excepciones

Comentarios

El valor del type parámetro se usa para establecer el AuthenticationType parámetro . Si type es null, el sistema de seguridad establece NegotiateAuthenticationType en en Windows Vista y versiones posteriores del sistema operativo Windows y Kerberos en versiones anteriores del sistema operativo Windows. El sistema de seguridad no utiliza este valor; es solo para uso informativo.

El UPN identificado en sUserPrincipalName se usa para recuperar un token para ese usuario a través de la función de la API LsaLogonUser de Windows. A su vez, ese token se usa para identificar al usuario. Es posible que se devuelva una excepción debido a la incapacidad de iniciar sesión con el UPN proporcionado.

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)

Parámetros

Excepciones

Ejemplos

En el código siguiente se muestra el uso del WindowsIdentity constructor para crear una nueva instancia de la WindowsIdentity clase para el usuario representado por el token de cuenta de Windows especificado, el tipo de autenticación especificado y el tipo de cuenta de Windows especificado. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase 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

Comentarios

En la tabla siguiente se muestran los valores de propiedad iniciales de una instancia de WindowsIdentity.

El valor del type parámetro se usa para establecer el AuthenticationType parámetro . Si type es null, el sistema de seguridad establece NegotiateAuthenticationType en en Windows Vista y versiones posteriores del sistema operativo Windows y Kerberos en versiones anteriores del sistema operativo Windows. El sistema de seguridad no utiliza este valor; es solo para uso informativo.

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)

Parámetros

Excepciones

Ejemplos

El código siguiente muestra el uso del WindowsIdentity constructor para crear una nueva instancia de la WindowsIdentity clase para el usuario representado por el token de cuenta de Windows especificado, el tipo de autenticación especificado, el tipo de cuenta de Windows especificado y el estado de autenticación especificado. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase 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

Comentarios

El valor del type parámetro se usa para establecer el AuthenticationType parámetro . Si type es null, el sistema de seguridad establece NegotiateAuthenticationType en en Windows Vista y versiones posteriores del sistema operativo Windows y Kerberos en versiones anteriores del sistema operativo Windows. El sistema de seguridad no utiliza este valor; es solo para uso informativo.

Puede recuperar el token representado mediante userToken una llamada a código no administrado, como la función de la API LogonUser de Windows. userToken Publique siempre mediante una llamada a la función de la API CloseHandle de Windows. Para obtener más información sobre cómo llamar a código no administrado, consulte Consumo de funciones DLL no administradas.