ZwQueryEaFile 함수(ntifs.h)
ZwQueryEaFile 루틴은 지정된 파일과 연결된 EA(확장 특성)를 반환합니다.
구문
NTSTATUS ZwQueryEaFile(
[in] HANDLE FileHandle,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[out] PVOID Buffer,
[in] ULONG Length,
[in] BOOLEAN ReturnSingleEntry,
[in, optional] PVOID EaList,
[in] ULONG EaListLength,
[in, optional] PULONG EaIndex,
[in] BOOLEAN RestartScan
);
매개 변수
[in] FileHandle
작업을 수행할 파일의 핸들입니다.
[out] IoStatusBlock
최종 완료 상태 수신하는 IO_STATUS_BLOCK 구조체 및 요청된 작업에 대한 기타 정보를 가리키는 포인터입니다.
[out] Buffer
파일의 EA를 반환할 호출자가 제공하는 FILE_FULL_EA_INFORMATION 구조화된 출력 버퍼에 대한 포인터입니다.
[in] Length
버퍼가 가리키는 버퍼의 길이(바이트)입니다.
[in] ReturnSingleEntry
ZwQueryEaFile이 찾은 첫 번째 항목만 반환해야 하는 경우 TRUE로 설정합니다.
[in, optional] EaList
쿼리할 EA를 지정하는 호출자가 제공하는 FILE_GET_EA_INFORMATION 구조화된 입력 버퍼에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
[in] EaListLength
EaList 매개 변수가 가리키는 버퍼의 길이(바이트)입니다.
[in, optional] EaIndex
파일의 EA 목록을 검사해야 하는 항목의 인덱스입니다. EaList가 없음 목록을 가리키는 경우 이 매개 변수는 무시됩니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
[in] RestartScan
ZwQueryEaFile이 파일의 EA 목록의 첫 번째 항목에서 검사를 시작해야 하는 경우 TRUE로 설정합니다. 이 매개 변수가 FALSE로 설정된 경우 루틴은 ZwQueryEaFile에 대한 이전 호출에서 검사를 다시 시작합니다.
반환 값
ZwQueryEaFile 은 STATUS_SUCCESS 또는 다음과 같은 적절한 NTSTATUS 값을 반환합니다.
반환 값 | Description |
---|---|
STATUS_EAS_NOT_SUPPORTED | 파일 시스템은 EA를 지원하지 않습니다. 오류 코드입니다. |
STATUS_INSUFFICIENT_RESOURCES | 작업을 완료하는 데 사용할 수 있는 메모리가 부족합니다. 오류 코드입니다. |
STATUS_EA_LIST_INCONSISTENT | EaList 매개 변수의 형식이 올바르게 지정되지 않았습니다. 오류 코드입니다. |
설명
ZwQueryEaFile이 반환하는 정보의 양은 EA의 크기와 버퍼가 가리키는 버퍼의 크기를 기반으로 합니다. 즉, 요청된 모든 EA가 버퍼에 기록되거나 모든 EA를 포함할 만큼 크지 않은 경우 버퍼가 전체 EA로 채워집니다. 전체 EA만 버퍼에 기록됩니다. 부분 EA는 반환되지 않습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 |
대상 플랫폼 | 유니버설 |
헤더 | ntifs.h(FltKernel.h, Ntifs.h 포함) |
라이브러리 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 규정 준수 규칙 | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |