IsTokenRestricted-Funktion (securitybaseapi.h)
Die IsTokenRestricted-Funktion gibt an, ob ein Token eine Liste mit eingeschränkten Sicherheitsbezeichnern (SIDs) enthält.
Syntax
BOOL IsTokenRestricted(
[in] HANDLE TokenHandle
);
Parameter
[in] TokenHandle
Ein Handle für ein zu testiges Zugriffstoken .
Rückgabewert
Wenn das Token eine Liste der einschränkenden SIDs enthält, ist der Rückgabewert ungleich null.
Wenn das Token keine Liste der einschränkenden SIDs enthält, ist der Rückgabewert 0 (null).
Wenn ein Fehler auftritt, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die CreateRestrictedToken-Funktion kann ein Token einschränken, indem SIDs deaktiviert, Berechtigungen gelöscht und eine Liste eingeschränkter SIDs angegeben wird. Die IsTokenRestricted-Funktion überprüft nur auf die Liste der einschränkenden SIDs. Wenn ein Token keine einschränkenden SIDs aufweist, gibt IsTokenRestrictedFALSE zurück, obwohl das Token durch einen Aufruf von CreateRestrictedToken erstellt wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | securitybaseapi.h (Einschließen von Windows.h) |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |