SeCaptureSubjectContext 함수(ntifs.h)
SeCaptureSubjectContext는 액세스 유효성 검사 및 감사를 위해 호출 스레드 컨텍스트의 스냅샷 사용합니다. SeCaptureSubjectContextEx도 참조하세요.
구문
void SeCaptureSubjectContext(
[out] PSECURITY_SUBJECT_CONTEXT SubjectContext
);
매개 변수
[out] SubjectContext
[out] 불투명 호출자가 할당한 SECURITY_SUBJECT_CONTEXT 구조체에 대한 포인터입니다. SeCaptureSubjectContext는 이 구조에서 액세스 토큰에 대한 참조를 포함하는 호출 스레드 보안 프로필의 스냅샷 작성합니다. 드라이버는 보안 결정을 내리기 위해 이 구조체의 멤버를 수정하거나 직접 액세스하려고 시도해서는 안 됩니다. 대신 권한 부여의 보안 문제를 방지하려면 SeAccessCheck 또는 SePrivilegeCheck 호출에서 이 불투명 구조를 전달합니다.
반환 값
없음
설명
액세스 유효성 검사 또는 감사 메시지 생성과 같은 서비스를 수행하기 전에 SeCaptureSubjectContext 를 호출해야 합니다. 이는 다음과 같은 루틴에 일관된 보안 컨텍스트를 제공하는 데 필요합니다.
액세스 유효성 검사, 권한 검사 및 감사 생성 서비스가 수행된 후 SeReleaseSubjectContext를 호출하여 캡처된 컨텍스트를 최대한 빨리 해제합니다.
SeCaptureSubjectContext는 호출 스레드의 보안 컨텍스트의 스냅샷 사용하는 동안 필요에 따라 토큰을 잠급니다.
반환할 때 액세스 토큰에 대한 참조는 SubjectContext 가 가리키는 구조에 포함됩니다. 해당 구조체의 내용이 변경 될 수 있습니다. 이를 방지하려면 SeLockSubjectContext 를 호출하여 기본 액세스 토큰 및 구조와 연결된 모든 가장 토큰을 잠급니다. 예를 들어 동일한 보안 컨텍스트에서 토큰 정보를 두 번 이상 쿼리하는 루틴을 사용하는 경우(예: 이전에 나열된 것과 같이) SeLockSubjectContext 를 사용하여 주체 컨텍스트를 잠가 일관된 결과를 얻습니다.
보안 및 액세스 제어에 대한 자세한 내용은 드라이버 개발자를 위한 Windows 보안 모델 및 Windows SDK의 이러한 topics 대한 설명서를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 |
| 대상 플랫폼 | 유니버설 |
| 헤더 | ntifs.h(Ntifs.h, Wdm.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |