FltRequestSecurityInfoOnCreateCompletion 함수(fltkernel.h)
미니필터는 파일을 미리 만드는 동안 FltRequestSecurityInfoOnCreateCompletion 을 호출하여 파일 시스템이 사후 생성 중에 검색을 위해 파일 보안 정보를 저장하도록 요청합니다.
구문
NTSTATUS FLTAPI FltRequestSecurityInfoOnCreateCompletion(
PFLT_FILTER Filter,
PFLT_CALLBACK_DATA Data,
SECURITY_INFORMATION SecurityInformation
);
매개 변수
Filter
미니필터 드라이버를 고유하게 식별하는 불투명 필터 포인터입니다.
Data
I/O 만들기 작업을 나타내는 FLT_CALLBACK_DATA 콜백 데이터에 대한 포인터입니다.
SecurityInformation
SECURITY_INFORMATION 다음 중 하나 이상의 조합으로 설정할 정보를 지정하는 값입니다.
| 값 | 의미 |
|---|---|
| OWNER_SECURITY_INFORMATION | 개체의 소유자 식별자를 설정할 것임을 나타냅니다. WRITE_OWNER 액세스가 필요합니다. |
| GROUP_SECURITY_INFORMATION | 개체의 기본 그룹 식별자를 설정할 것임을 나타냅니다. WRITE_OWNER 액세스가 필요합니다. |
| DACL_SECURITY_INFORMATION | 개체의 DACL(임의 액세스 제어 목록)을 설정할 것임을 나타냅니다. WRITE_DAC 액세스가 필요합니다. |
| SACL_SECURITY_INFORMATION | 개체의 시스템 ACL(SACL)을 설정할 것임을 나타냅니다. ACCESS_SYSTEM_SECURITY 액세스가 필요합니다. |
반환 값
FltRequestSecurityInfoOnCreateCompletion 은 다음 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_SUCCESS | 파일 시스템에서 요청된 파일 보안 정보를 성공적으로 저장했습니다. |
| STATUS_INSUFFICIENT_RESOURCES | FltRequestSecurityInfoOnCreateCompletion 에서 요청된 파일 정보를 저장할 충분한 메모리를 할당할 수 없습니다. |
| STATUS_INVALID_PARAMETER_2 | 제공된 콜백 데이터 개체가 IRP 기반 만들기 작업이 아닙니다. |
설명
미니필터는 사후 생성 중에 FltRetrieveFileInfoOnCreateCompletionEx 또는 FltRetrieveFileInfoOnCreateCompletion 을 호출하여 파일 정보를 검색할 수 있습니다. 미니필터의 성능은 일반적으로 나중에 파일 정보를 쿼리하는 대신 이러한 방식으로 파일 정보를 요청하고 검색할 때 더 좋습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 11 버전 24H2 |
| 머리글 | fltkernel.h(Fltkernel.h 포함) |