_WinAPI_DuplicateTokenEx
Beschreibung anzeigen in
Erstellt einen neuen Primär- oder Immitierungszugangstoken welcher einen bereits existieren Token dubliziert
#include <WinAPIProc.au3>
_WinAPI_DuplicateTokenEx ( $hToken, $iAccess, $iLevel [, $iType = $TOKENPRIMARY [, $tSecurity = 0]] )
Parameter
| $hToken | Das Handle zu einem Zugangstoken welcher mit dem $TOKEN_DUPLICATE Zugang geöffnet wurde. |
| $iAccess | Die angeforderten Zugriffsrecht für einen neuen Token. Um die selben Zugangsrechte wie für den bereits bestehenden Token anzuforden muss $iAccess 0 sein. Um alle Zugangsrechte, welche für den Aufrufer gültig sind, zu fordern, sollte man $TOKEN_ALL_ACCESS verwenden. |
| $iLevel | Die Sicherheitsimmitationslevels. $SECURITYANONYMOUS $SECURITYIDENTIFICATION $SECURITYIMPERSONATION $SECURITYDELEGATION |
| $iType | [optional] Der Tokentyp. $TOKENPRIMARY (Standard) $TOKENIMPERSONATION |
| $tSecurity | [optional] Die $tagSECURITY_ATTRIBUTES Struktur gibt einen Sicherheitsdeskriptor für einen neuen Token an und gibt ab ob Kindprozesse diesen Token erben können. Wenn dieser Parameter 0 ist (Standard), dann bekommt der Token einen Standardsicherheitsdeskriptor und das Handle kann nicht vererbt werden. Wenn der Sicherheitsdeskriptor eine Systemzugangskontrollliste (system access control list) beinhaltet, so bekommt der Token den $ACCESS_SYSTEM_SECURITY Zugang auch wenn dieser nicht angefordert wurde. |
Rückgabewert
| Erfolg: | Das Handle zu dem neuen Token. |
| Fehler: | 0. Es ist _WinAPI_GetLastError() aufzurufen um erweiterte Fehlerinformationen zu erhalten. |
Bemerkungen
Wenn man mit dem neuen Token fertig ist, so sollte man die _WinAPI_CloseHandle() Funktion aufrufen um das Handle des Tokens zu schließen.
Verwandte Funktionen
Siehe auch
Suche nach DuplicateTokenEx in der MSDN Bibliothek.