ZwQueryObject 함수(ntifs.h)

ZwQueryObject 루틴은 제공된 개체에 대한 정보를 제공합니다.

구문

NTSYSAPI NTSTATUS ZwQueryObject(
  [in, optional]  HANDLE                   Handle,
  [in]            OBJECT_INFORMATION_CLASS ObjectInformationClass,
  [out, optional] PVOID                    ObjectInformation,
  [in]            ULONG                    ObjectInformationLength,
  [out, optional] PULONG                   ReturnLength
);

매개 변수

[in, optional] Handle

정보를 가져올 개체에 대한 핸들입니다.

[in] ObjectInformationClass

ObjectInformation 버퍼에서 반환되는 정보의 형식을 결정하는 OBJECT_INFORMATION_CLASS 값을 지정합니다.

[out, optional] ObjectInformation

요청된 정보를 수신하는 호출자가 할당한 버퍼에 대한 포인터입니다.

[in] ObjectInformationLength

ObjectInformation 버퍼의 크기(바이트)를 지정합니다.

[out, optional] ReturnLength

요청된 키 정보의 크기(바이트)를 수신하는 변수에 대한 포인터입니다. ZwQueryObject가 STATUS_SUCCESS 반환하는 경우 변수에는 반환되는 데이터 양이 포함됩니다. ZwQueryObject가 STATUS_BUFFER_OVERFLOW 또는 STATUS_BUFFER_TOO_SMALL 반환하는 경우 변수 값을 사용하여 필요한 버퍼 크기를 확인할 수 있습니다.

반환 값

ZwQueryObject는 STATUS_SUCCESS 또는 적절한 오류 상태 반환합니다. 가능한 오류 상태 코드에는 다음이 포함됩니다.

반환 코드	설명
STATUS_ACCESS_DENIED	이 쿼리를 수행할 수 있는 권한이 부족했습니다.
STATUS_INVALID_HANDLE	제공된 개체 핸들이 잘못되었습니다.
STATUS_INFO_LENGTH_MISMATCH	정보 길이가 데이터를 보유하기에 충분하지 않습니다.

설명

ZwQueryObject 함수에 대한 호출이 사용자 모드에서 발생하는 경우 "ZwQueryObject" 대신 "NtQueryObject"라는 이름을 사용해야 합니다.

커널 모드 드라이버에서 호출하는 경우 Windows 네이티브 시스템 서비스 루틴의 NtXxx 및 ZwXxx 버전은 입력 매개 변수를 처리하고 해석하는 방식으로 다르게 동작할 수 있습니다. 루틴의 NtXxx 버전과 ZwXxx 버전 간의 관계에 대한 자세한 내용은 네이티브 시스템 서비스 루틴의 Nt 및 Zw 버전 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000.
대상 플랫폼	유니버설
헤더	ntifs.h(Ntifs.h, FltKernel.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

추가 정보

OBJECT_INFORMATION_CLASS

PUBLIC_OBJECT_BASIC_INFORMATION

PUBLIC_OBJECT_TYPE_INFORMATION

네이티브 시스템 서비스 루틴의 Nt 및 Zw 버전 사용