Макрос SeQuerySubjectContextToken (ntifs.h)

Статья
11/14/2023

Макрос SeQuerySubjectContextToken извлекает маркер доступа для контекста субъекта безопасности.

Синтаксис

PACESS_TOKEN
SeQuerySubjectContextToken(SubjectContext);

Параметры

SubjectContext

[in] Указатель на непрозрачную структуру SECURITY_SUBJECT_CONTEXT , содержащую контекст субъекта для запроса. Эта непрозрачная структура была получена из операционной системы при вызове SeCaptureSubjectContextEx или SeCaptureSubjectContext. Драйверы не должны изменять или пытаться напрямую обращаться к каким-либо членам этой структуры для принятия решений по обеспечению безопасности.

Возвращаемое значение

None

Remarks

SeQuerySubjectContextToken возвращает действующий токен из SubjectContext. Действующий маркер — это маркер клиента, если он имеется; в противном случае это основной (процессный) маркер.

SeQuerySubjectContextToken может возвращать основной маркер или токен олицетворения. Так как драйверы не должны напрямую обращаться к каким-либо членам структуры SECURITY_SUBJECT_CONTEXT , необходимо сначала передать его в SeAccessCheck или SePrivilegeCheck , чтобы избежать проблем с безопасностью при авторизации; Например, если это токен олицетворения, требуется уровень олицетворения SecurityImpersonation или выше. После подтверждения состояния авторизации можно передать указатель маркера доступа, возвращенный SeQuerySubjectContextToken , в SeQueryInformationToken.

SeQuerySubjectContextToken не влияет на состояние блокировки или маркер доступа контекста субъекта.

Дополнительные сведения о безопасности и управлении доступом см. в статье Модель безопасности Windows для разработчиков драйверов и в документации по этим темам в windows SDK.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000
Целевая платформа	Персональный компьютер
Верхняя часть	ntifs.h (включая Ntifs.h)
IRQL	PASSIVE_LEVEL