Función SeCaptureSubjectContext (ntifs.h)
SeCaptureSubjectContext toma una instantánea del contexto del subproceso de llamada para la validación y auditoría de acceso. Consulte también seCaptureSubjectContextEx .
Sintaxis
void SeCaptureSubjectContext(
[out] PSECURITY_SUBJECT_CONTEXT SubjectContext
);
Parámetros
[out] SubjectContext
[out] Puntero a una estructura de SECURITY_SUBJECT_CONTEXT asignada por el autor de llamada opaco. seCaptureSubjectContext escribirá la instantánea del perfil de seguridad del subproceso que llama, que contiene referencias a tokens de acceso, en esta estructura. Los controladores no deben modificar ni intentar acceder directamente a ningún miembro de esta estructura para tomar decisiones de seguridad. En su lugar, para evitar problemas de seguridad en la autorización, pase esta estructura opaca en llamadas a SeAccessCheck o SePrivilegeCheck.
Valor devuelto
Ninguno
Observaciones
Debe llamar a SeCaptureSubjectContext antes de realizar servicios como la validación de acceso o generar mensajes de auditoría. Esto es necesario para proporcionar un contexto de seguridad coherente a rutinas como las siguientes:
- SeQueryAuthenticationIdToken
- SeQuerySubjectContextToken
- seQueryInformationToken
- SePrivilegeCheck
Después de realizar la validación de acceso, la comprobación de privilegios y los servicios de generación de auditoría, libere el contexto capturado lo antes posible llamando a SeReleaseSubjectContext.
SeCaptureSubjectContext bloquea los tokens según sea necesario mientras toma la instantánea del contexto de seguridad del subproceso que realiza la llamada.
A cambio, las referencias a los tokens de acceso se encuentran en la estructura a la que SubjectContext apunta. El contenido de esa estructura puede cambiar. Para evitar esto, llame a seLockSubjectContext para bloquear el token de acceso principal y los tokens de suplantación asociados a la estructura. Por ejemplo, al usar rutinas que consultan información de token más de una vez en el mismo contexto de seguridad (como los enumerados anteriormente), bloquee el contexto del asunto con seLockSubjectContext para obtener resultados coherentes.
Para obtener más información sobre la seguridad y el control de acceso, consulte modelo de seguridad de Windows para desarrolladores de controladores y la documentación sobre estos temas en Windows SDK.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 |
| de la plataforma de destino de | Universal |
| encabezado de | ntifs.h (incluya Ntifs.h, Wdm.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | PASSIVE_LEVEL |