ZwSetEaFile 함수(ntifs.h)

ZwSetEaFile 은 파일과 연결된 EA(확장 특성)를 지정된 EA로 바꿉니다.

구문

NTSTATUS ZwSetEaFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock,
  [in]  PVOID            Buffer,
  [in]  ULONG            Length
);

매개 변수

[in] FileHandle

작업을 수행할 파일의 핸들입니다.

[out] IoStatusBlock

최종 완료 상태 수신하는 IO_STATUS_BLOCK 구조체에 대한 포인터 및 요청된 작업에 대한 기타 정보입니다.

[in] Buffer

현재 파일과 연결된 EA를 대체할 새 EA를 포함하는 호출자가 제공한 FILE_FULL_EA_INFORMATION 구조화된 입력 버퍼에 대한 포인터입니다.

[in] Length

Buffer 매개 변수가 가리키는 버퍼의 길이(바이트)입니다.

반환 값

ZwSetEaFile 은 STATUS_SUCCESS 또는 다음과 같은 적절한 NTSTATUS 값을 반환합니다.

반환 값	Description
STATUS_EA_LIST_INCONSISTENT	버퍼가 가리키는 EA 목록의 형식이 올바르게 지정되지 않았습니다. 오류 코드입니다.
STATUS_INSUFFICIENT_RESOURCES	작업을 완료하는 데 사용할 수 있는 메모리가 부족합니다. 오류 코드입니다.

설명

ZwSetEaFile 은 FileHandle 과 연결된 EA를 버퍼 가 가리키는 버퍼의 EA로 바꿉니다. 버퍼의 EA는 FILE_FULL_EA_INFORMATION 구조의 시퀀스로 형식이 지정되어야 합니다. ZwSetEaFile 은 먼저 기존 EA를 바꾸기 전에 EA 값의 버퍼가 유효한지 확인 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000
대상 플랫폼	유니버설
헤더	ntifs.h(FltKernel.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

추가 정보

FILE_FULL_EA_INFORMATION

IoCheckEaBufferValidity

ZwQueryEaFile