Funktionreferenz


_Security__OpenThreadTokenEx

Beschreibung anzeigen in

Öffnet das Access-Token, welches mit einem Thread verbunden ist und personifiziert den Sicherheitskontext des Client-Prozesses, falls notwendig

#include <Security.au3>
_Security__OpenThreadTokenEx ( $iAccess [, $hThread = 0 [, $bOpenAsSelf = False]] )

Parameter

$iAccess Access-Maske, welche die benötigten Zugriffsarten auf das Access-Token festlegt. Diese angeforderten
Zugriffsarten werden mit der Discretionary Access Control List (DACL) abgeglichen, um festzustellen, welche Zugriffe erlaubt bzw. verboten sind.
$hThread [optional] Handle zu dem Thread, dessen Access-Token geöffnet wurde
$bOpenAsSelf [optional] Zeigt an, ob der Zugriffscheck gegen den Sicherheitskontext des Threads durch Aufruf der Funktion OpenThreadToken oder gegen gegen den Sicherheitskontext des Prozesses für den aufgerufenen Thread erfolgen soll.
Falls dieses Parameter False ist, so wird der Sicherheitscheck durch Verwenden des Sicherheitskontexts für den aufgerufenen Thread durchgeführt.
Falls der Thread einen Client personifiziert, kann dieser Sicherheitskontext der Client-Prozess sein.
Falls dieser Parameter True ist, so wird der Sicherheitscheck durch Verwenden des Sicherheitskontexts des Prozesses für den aufgerufenen Thread durchgeführt.

Rückgabewert

Erfolg: Handle zu dem kürzlich geöffneten Access-Token.
Fehler: 0.

Verwandte Funktionen

_Security__ImpersonateSelf, _Security__OpenThreadToken

Beispiel

#include <MsgBoxConstants.au3>
#include <Security.au3>
#include <SecurityConstants.au3>
#include <WinAPIError.au3>
#include <WinAPIHObj.au3>

Local $hToken = _Security__OpenThreadTokenEx($TOKEN_ADJUST_PRIVILEGES)
If $hToken Then
    ; $hToken ist das Threadtoken mit $TOKEN_ADJUST_PRIVILEGES Zugriff.
    MsgBox($MB_SYSTEMMODAL, "OpenThreadTokenEx", "$hToken = " & $hToken)

    _WinAPI_CloseHandle($hToken)
Else
    ConsoleWrite("! _Security__OpenThreadTokenEx ERROR. Fehler: " & _WinAPI_GetLastErrorMessage())
EndIf