Fonction SeCaptureSubjectContext (wdm.h)

Article
02/29/2024

La routine SeCaptureSubjectContext capture le contexte de sécurité du thread appelant pour la validation et l’audit de l’accès.

Syntaxe

void SeCaptureSubjectContext(
  [out] PSECURITY_SUBJECT_CONTEXT SubjectContext
);

Paramètres

[out] SubjectContext

Pointeur vers une structure de SECURITY_SUBJECT_CONTEXT allouée à l’appelant .

Valeur de retour

None

Remarques

La routine SeCaptureSubjectContext retourne un pointeur vers une structure SECURITY_SUBJECT_CONTEXT , qui contient des références aux jetons d’accès. Le contenu de cette structure peut changer. La routine SeLockSubjectContext verrouille le jeton d’accès principal et tous les jetons d’emprunt d’identité associés à la structure.

Lorsque vous utilisez des routines qui interrogent des informations de jeton, telles que SeQueryAuthenticationIdToken, SeQuerySubjectContextToken, SeQueryInformationToken et SePrivilegeCheck, plusieurs fois dans le même contexte de sécurité, verrouillez le contexte de l’objet avec SeLockSubjectContext pour obtenir des résultats cohérents.

Les systèmes de fichiers doivent appeler SeCaptureSubjectContext avant d’effectuer la validation de l’accès ou de générer des messages d’audit. Cela est nécessaire pour fournir un contexte de sécurité cohérent aux routines telles que SeQueryAuthenticationIdToken, SeQuerySubjectContextToken et SePrivilegeCheck. Une fois ces opérations effectuées, le contexte capturé doit être libéré dès que possible en appelant SeReleaseSubjectContext.

Pour plus d’informations sur la sécurité et le contrôle d’accès, consultez la documentation sur ces rubriques dans la Microsoft Windows SDK.