WindowsIdentity-Konstruktor (IntPtr, String)

Artikel
08/20/2007

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

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

Syntax

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

Dim instance As New WindowsIdentity(userToken, type)

public WindowsIdentity (
    IntPtr userToken,
    string type
)

public:
WindowsIdentity (
    IntPtr userToken, 
    String^ type
)

public WindowsIdentity (
    IntPtr userToken, 
    String type
)

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

Parameter

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

type
Der zur Identifizierung des Benutzers verwendete Authentifizierungstyp.

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
WindowsAccountType	Normal
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 und den angegebenen Authentifizierungstyp dargestellt wird. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die WindowsIdentity-Klasse.

Dim authenticationType = "WindowsAuthentication"
Dim windowsIdentity As _
    New WindowsIdentity(logonToken, authenticationType)

string authenticationType = "WindowsAuthentication";
WindowsIdentity windowsIdentity =
    new WindowsIdentity(logonToken, authenticationType);

String^ authenticationType = "WindowsAuthentication";
WindowsIdentity^ windowsIdentity = gcnew WindowsIdentity( logonToken,authenticationType );

String authenticationType = "WindowsAuthentication";
WindowsIdentity windowsIdentity =
    new WindowsIdentity(logonToken, authenticationType);

.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