Función IsTokenRestricted (securitybaseapi.h)

La función IsTokenRestricted indica si un token contiene una lista de identificadores de seguridad restringidos (SID).

Sintaxis

BOOL IsTokenRestricted(
  [in] HANDLE TokenHandle
);

Parámetros

[in] TokenHandle

Identificador de un token de acceso que se va a probar.

Valor devuelto

Si el token contiene una lista de restricciones de SID, el valor devuelto es distinto de cero.

Si el token no contiene una lista de SID de restricción, el valor devuelto es cero.

Si se produce un error, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función CreateRestrictedToken puede restringir un token deshabilitando los SID, eliminando privilegios y especificando una lista de SID de restricción. La función IsTokenRestricted comprueba solo la lista de SID de restricción. Si un token no tiene ningún SID de restricción, IsTokenRestricted devuelve FALSE, aunque el token se creó mediante una llamada a CreateRestrictedToken.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	securitybaseapi.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll

Consulte también

Información general del control de acceso

Funciones básicas de Access Control

CreateRestrictedToken