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

설명

ZwQueryEaFile이 반환하는 정보의 양은 EA의 크기와 버퍼가 가리키는 버퍼의 크기를 기반으로 합니다. 즉, 요청된 모든 EA가 버퍼에 기록되거나 모든 EA를 포함할 만큼 크지 않은 경우 버퍼가 전체 EA로 채워집니다. 전체 EA만 버퍼에 기록됩니다. 부분 EA는 반환되지 않습니다.

요구 사항

추가 정보

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile