FsRtlSetKernelEaFile 함수(ntifs.h)

FsRtlQueryKernelEaFile 루틴은 파일에 대한 EA(확장 특성) 값을 설정, 수정 및/또는 삭제하고 동기적으로 완료될 때까지 기다렸다가 결과를 반환하는 데 사용됩니다. 이 API가 SecureEA를 설정할 수 있도록 하는 IRP_MN_KERNEL 부 코드를 설정합니다. 이렇게 하면 호출자가 핸들 대신 FileObject에서 이 작업을 수행할 수 있습니다.

통사론

NTSTATUS FsRtlSetKernelEaFile(
  [in] PFILE_OBJECT FileObject,
  [in] PVOID        EaBuffer,
  [in] ULONG        Length
);

매개 변수

[in] FileObject

QueryEA 요청을 보낼 FileObject 대한 포인터입니다.

[in] EaBuffer

설정할 확장 특성 값을 포함하는 호출자가 제공하는 FILE_FULL_EA_INFORMATION구조화된 입력 버퍼에 대한 포인터입니다.

[in] Length

EA 버퍼의 길이를 지정합니다.

반환 값

FsRtlSetKernelEaFile 루틴은 작업의 상태를 수신하고 상태 코드 중 하나를 반환합니다.

반환 코드	묘사
STATUS_EA_LIST_INCONSISTENT	EaList 매개 변수의 형식이 올바르게 지정되지 않았습니다.
STATUS_EAS_NOT_SUPPORTED	파일 시스템은 확장 특성을 지원하지 않습니다.
STATUS_INSUFFICIENT_RESOURCES	IRP(I/O 요청 패킷)를 이 요청에 할당할 수 없습니다.
STATUS_INTERMIXED_KERNEL_EA_OPERATION	요청은 동일한 호출에서 일반 및 커널 EA를 섞을 수 없습니다.
STATUS_INVALID_DEVICE_REQUEST	직접 디바이스가 열려 있으므로 요청이 실패했습니다.
STATUS_SUCCESS	요청이 성공했습니다.

발언

이 루틴은 버퍼에 전달된 모든 것이 커널 모드에서 온 것이라고 가정합니다.

FsRtlSetKernelEaFile단일 호출에서 하나 이상의 커널 EA를 설정, 수정 및/또는 삭제할 수 있습니다. 일반 EA는 FsRtlSetKernelEaFile 함수를 사용하여 설정할 수도 있습니다. EaValueLength 0으로 EAName 지정하여 EA를 삭제합니다. 단일 호출에서 새 삽입, 기존 수정 또는 EA 제거를 섞을 수 있습니다.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	Windows
헤더	ntifs.h

참고 항목

FsRtlQueryKernelEaFile

ZwQueryEaFile

ZwSetEaFile