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) |