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 값을 반환합니다.

반환 값	묘사
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)

참고 항목

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile