다음을 통해 공유

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" 이름을 사용해야 합니다.

커널 모드 드라이버의 호출의 경우 NtXxx 및 ZwXxx 버전의 Windows Native System Services 루틴은 입력 매개 변수를 처리하고 해석하는 방식으로 다르게 동작할 수 있습니다. 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 버전 사용