WindowsIdentity-Konstruktor (IntPtr, String, WindowsAccountType, Boolean)

Artikel
08/20/2007

Initialisiert eine neue Instanz der WindowsIdentity-Klasse für den Benutzer, der durch das angegebene Windows-Kontotoken, den angegebenen Authentifizierungstyp, den angegebenen Windows-Kontotyp und den angegebenen Authentifizierungsstatus dargestellt wird.

Namespace: System.Security.Principal
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Sub New ( _
    userToken As IntPtr, _
    type As String, _
    acctType As WindowsAccountType, _
    isAuthenticated As Boolean _
)
'Usage
Dim userToken As IntPtr
Dim type As String
Dim acctType As WindowsAccountType
Dim isAuthenticated As Boolean

Dim instance As New WindowsIdentity(userToken, type, acctType, isAuthenticated)

public WindowsIdentity (
    IntPtr userToken,
    string type,
    WindowsAccountType acctType,
    bool isAuthenticated
)

public:
WindowsIdentity (
    IntPtr userToken, 
    String^ type, 
    WindowsAccountType acctType, 
    bool isAuthenticated
)

public WindowsIdentity (
    IntPtr userToken, 
    String type, 
    WindowsAccountType acctType, 
    boolean isAuthenticated
)

public function WindowsIdentity (
    userToken : IntPtr, 
    type : String, 
    acctType : WindowsAccountType, 
    isAuthenticated : boolean
)

Parameter

userToken
Das Kontotoken für den Benutzer, für den der Code ausgeführt wird.

type
Der zur Identifizierung des Benutzers verwendete Authentifizierungstyp.

acctType
Einer der WindowsAccountType-Werte.

isAuthenticated
true, um anzugeben, dass der Benutzer authentifiziert ist, andernfalls false.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	userToken ist 0 (null). – oder – userToken ist dupliziert und für Identitätswechsel ungültig.
SecurityException	Der Aufrufer verfügt nicht über die erforderlichen Berechtigungen. – oder – Es ist ein Win32-Fehler aufgetreten.

ArgumentException

userToken ist 0 (null).

– oder –

userToken ist dupliziert und für Identitätswechsel ungültig.

SecurityException

Der Aufrufer verfügt nicht über die erforderlichen Berechtigungen.

– oder –

Es ist ein Win32-Fehler aufgetreten.

Hinweise

Das von userToken dargestellte Token wird normalerweise über einen Aufruf von nicht verwaltetem Code abgerufen, z. B. einen Aufruf der Win32-API-LogonUser-Funktion. Weitere Informationen zum Aufrufen von nicht verwaltetem Code finden Sie unter Verwenden nicht verwalteter DLL-Funktionen.

Beispiel

Im folgenden Code wird veranschaulicht, wie der WindowsIdentity-Konstruktor verwendet wird, um eine neue Instanz der WindowsIdentity-Klasse für den Benutzer zu erstellen, der durch das angegebene Windows-Kontotoken, den angegebenen Authentifizierungstyp, den angegebenen Windows-Kontotyp und den angegebenen Authentifizierungsstatus dargestellt wird. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die WindowsIdentity-Klasse.

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)

string authenticationType = "WindowsAuthentication";
WindowsAccountType guestAccount = WindowsAccountType.Guest;
bool isAuthenticated = true;
WindowsIdentity windowsIdentity = new WindowsIdentity(
    logonToken, authenticationType, guestAccount, isAuthenticated);

String^ authenticationType = "WindowsAuthentication";
WindowsAccountType guestAccount = WindowsAccountType::Guest;
bool isAuthenticated = true;
WindowsIdentity^ windowsIdentity = gcnew WindowsIdentity( logonToken,authenticationType,guestAccount,isAuthenticated );

String authenticationType = "WindowsAuthentication";
WindowsAccountType guestAccount = WindowsAccountType.Guest;
boolean isAuthenticated = true;
WindowsIdentity windowsIdentity = new WindowsIdentity(logonToken,
    authenticationType, guestAccount, isAuthenticated);

.NET Framework-Sicherheit

SecurityPermission für die Möglichkeit zum Bearbeiten des Hauptobjekts. Zugeordnete Enumeration: SecurityPermissionFlag.ControlPrincipal.
SecurityPermission für den Zugriff auf nicht verwalteten Code. Zugeordnete Enumeration: SecurityPermissionFlag.UnmanagedCode.

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

WindowsIdentity-Klasse
WindowsIdentity-Member
System.Security.Principal-Namespace

Freigeben über