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

Weitere Informationen

Zugriffssteuerung Übersicht

Grundlegende Access Control-Funktionen

CreateRestrictedToken