ZwQueryInformationByName 함수(wdm.h)

아티클
08/08/2023

ZwQueryInformationByName 은 파일 이름으로 지정된 파일에 대해 요청된 정보를 반환합니다.

구문

NTSYSAPI NTSTATUS ZwQueryInformationByName(
  [in]  POBJECT_ATTRIBUTES     ObjectAttributes,
  [out] PIO_STATUS_BLOCK       IoStatusBlock,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass
);

매개 변수

[in] ObjectAttributes

파일 이름을 포함하여 파일의 특성을 포함하는 OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다.

[out] IoStatusBlock

호출자의 I/O 상태 포함하는 IO_STATUS_BLOCK 구조체를 가리키는 포인터입니다.

[out] FileInformation

파일에 대한 요청된 정보를 반환할 호출자가 제공한 버퍼에 대한 포인터입니다. 버퍼의 구조는 FileInformationClass 매개 변수에 의해 결정됩니다.

[in] Length

FileInformation이 가리키는 버퍼의 길이(바이트)입니다.

[in] FileInformationClass

FileInformation이 가리키는 버퍼에서 반환할 파일 정보의 형식을 식별하는 FILE_INFORMATION_CLASS 값입니다. FileInformationClass 는 다음 값 중 하나일 수 있습니다.

FILE_INFORMATION_CLASS 값	반환할 정보 유형
FileStatInformation (68)	FILE_STAT_INFORMATION. Windows 10 버전 1709부터 사용할 수 있습니다.
FileStatLxInformation (70)	FILE_STAT_LX_INFORMATION. Windows 10 2018년 4월 업데이트부터 사용할 수 있습니다.
FileCaseSensitiveInformation (71)	FILE_CASE_SENSITIVE_INFORMATION. Windows 10 2018년 4월 업데이트부터 사용할 수 있습니다.

반환 값

ZwQueryInformationByName은 성공적으로 완료되면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 다음 중 하나와 같은 오류 코드를 반환합니다.

오류 코드	의미
STATUS_INVALID_PARAMETER	FileInformationClass 매개 변수에 잘못된 값이 포함되어 있습니다.
STATUS_INFO_LENGTH_MISMATCH	Length로 지정된 버퍼 크기가 요청된 정보를 포함할 만큼 크지 않습니다.