WindowsIdentity-Konstruktor (IntPtr, String, WindowsAccountType)

Artikel
08/20/2007

Initialisiert eine neue Instanz der WindowsIdentity-Klasse für den Benutzer, der durch das angegebene Windows-Kontotoken, den angegebenen Authentifizierungstyp und den angegebenen Windows-Kontotyp 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 _
)
'Usage
Dim userToken As IntPtr
Dim type As String
Dim acctType As WindowsAccountType

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

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

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

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

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

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.

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

In der folgenden Tabelle werden die anfänglichen Eigenschaftenwerte für eine Instanz von WindowsIdentity aufgeführt.

Eigenschaft	Anfangswert
IsAuthenticated	false

Hinweis

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 und den angegebenen Windows-Kontotyp 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 windowsIdentity As _
    New WindowsIdentity(logonToken, authenticationType, guestAccount)

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

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

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

.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