WindowsIdentity Constructeurs

public:
 WindowsIdentity(IntPtr userToken);

public WindowsIdentity(IntPtr userToken);

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

Public Sub New (userToken As IntPtr)

Paramètres

Exceptions

Remarques

Le tableau suivant présente les valeurs de propriété initiales d’une instance 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)

Paramètres

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)

Paramètres

Exceptions

Remarques

Un UPN a le formatnom de domaine dunom d’utilisateur@.com, en d’autres termes, une adresse e-mail. L’UPN identifié dans sUserPrincipalName est utilisé pour récupérer un jeton pour cet utilisateur via la fonction API LsaLogonUser Windows. À son tour, ce jeton est utilisé pour identifier l’utilisateur. Une exception peut être retournée en raison de l’incapacité de se connecter à l’aide de l’UPN fournie.

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)

Paramètres

Exceptions

Exemples

Le code suivant montre l’utilisation du WindowsIdentity constructeur pour créer une instance de la WindowsIdentity classe pour l’utilisateur représenté par le jeton de compte Windows spécifié et le type d’authentification spécifié. Cet exemple de code fait partie d’un exemple plus grand fourni pour la WindowsIdentity classe.

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

Remarques

Le tableau suivant présente les valeurs de propriété initiales d’une instance de WindowsIdentity.

La valeur du type paramètre est utilisée pour définir le AuthenticationType paramètre. Si type c’est nullle cas, le système de sécurité est défini AuthenticationTypeNegotiate sur Windows Vista et les versions ultérieures du système d’exploitation Windows, ainsi Kerberos que sur les versions antérieures du système d’exploitation Windows. Le système de sécurité n’utilise pas cette valeur ; il s’agit uniquement d’une utilisation informationnelle.

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)

Paramètres

Attributs

ObsoleteAttribute

Exceptions

Remarques

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)

Paramètres

Exceptions

Remarques

La valeur du type paramètre est utilisée pour définir le AuthenticationType paramètre. Si type c’est nullle cas, le système de sécurité est défini AuthenticationTypeNegotiate sur Windows Vista et les versions ultérieures du système d’exploitation Windows, ainsi Kerberos que sur les versions antérieures du système d’exploitation Windows. Le système de sécurité n’utilise pas cette valeur ; il s’agit uniquement d’une utilisation informationnelle.

L’UPN identifié dans sUserPrincipalName est utilisé pour récupérer un jeton pour cet utilisateur via la fonction API LsaLogonUser Windows. À son tour, ce jeton est utilisé pour identifier l’utilisateur. Une exception peut être retournée en raison de l’incapacité de se connecter à l’aide de l’UPN fournie.

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)

Paramètres

Exceptions

Exemples

Le code suivant montre l’utilisation du constructeur pour créer une instance de la WindowsIdentity classe pour l’utilisateur représenté par le jeton de compte Windows spécifié, le type d’authentification WindowsIdentity spécifié et le type de compte Windows spécifié. Cet exemple de code fait partie d’un exemple plus grand fourni pour la WindowsIdentity classe.

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

Remarques

Le tableau suivant présente les valeurs de propriété initiales d’une instance de WindowsIdentity.

La valeur du type paramètre est utilisée pour définir le AuthenticationType paramètre. Si type c’est nullle cas, le système de sécurité est défini AuthenticationTypeNegotiate sur Windows Vista et les versions ultérieures du système d’exploitation Windows, ainsi Kerberos que sur les versions antérieures du système d’exploitation Windows. Le système de sécurité n’utilise pas cette valeur ; il s’agit uniquement d’une utilisation informationnelle.

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)

Paramètres

Exceptions

Exemples

Le code suivant montre l’utilisation du constructeur pour créer une instance de la WindowsIdentity classe pour l’utilisateur représenté par le jeton de compte Windows spécifié, le type d’authentification WindowsIdentity spécifié, le type de compte Windows spécifié et l’état d’authentification spécifié. Cet exemple de code fait partie d’un exemple plus grand fourni pour la WindowsIdentity classe.

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

Remarques

La valeur du type paramètre est utilisée pour définir le AuthenticationType paramètre. Si type c’est nullle cas, le système de sécurité est défini AuthenticationTypeNegotiate sur Windows Vista et les versions ultérieures du système d’exploitation Windows, ainsi Kerberos que sur les versions antérieures du système d’exploitation Windows. Le système de sécurité n’utilise pas cette valeur ; il s’agit uniquement d’une utilisation informationnelle.

Vous pouvez récupérer le jeton représenté par userToken l’appel de code non managé tel que la fonction API LogonUser Windows. Toujours libérer userToken en appelant la fonction API CloseHandle Windows. Pour plus d’informations sur l’appel de code non managé, consultez Consommation de fonctions DLL non managées.