NtQueryDirectoryObject 함수

[이 함수는 나중에 변경되거나 사용할 수 없습니다.]

지정된 디렉터리 개체에 대한 정보를 검색합니다.

구문

NTSTATUS WINAPI NtQueryDirectoryObject(
  _In_      HANDLE  DirectoryHandle,
  _Out_opt_ PVOID   Buffer,
  _In_      ULONG   Length,
  _In_      BOOLEAN ReturnSingleEntry,
  _In_      BOOLEAN RestartScan,
  _Inout_   PULONG  Context,
  _Out_opt_ PULONG  ReturnLength
);

매개 변수

DirectoryHandle [in]

디렉터리 개체에 대한 핸들입니다.

버퍼 [out, 선택 사항]

디렉터리 정보를 수신하는 버퍼에 대한 포인터입니다. 이 버퍼는 하나 이상의 OBJECT_DIRECTORY_INFORMATION 구조체( 마지막 구조체는 NULL) 뒤에 디렉터리 항목의 이름을 포함하는 문자열을 받습니다. 자세한 내용은 설명 부분을 참조하세요.

길이 [in]

사용자가 제공한 출력 버퍼의 크기(바이트)입니다.

ReturnSingleEntry [in]

함수가 단일 항목만 반환해야 하는지 여부를 나타냅니다.

RestartScan [in]

Context 매개 변수에 전달된 정보를 사용하여 검사를 다시 시작할지 아니면 열거형을 계속할지 여부를 나타냅니다.

컨텍스트 [in, out]

열거형 컨텍스트입니다.

ReturnLength [out, optional]

출력 버퍼에 반환된 디렉터리 정보의 길이를 바이트 단위로 받는 변수에 대한 포인터입니다.

반환 값

함수는 STATUS_SUCCESS 또는 오류 상태 반환합니다.

설명

다음은 OBJECT_DIRECTORY_INFORMATION 구조체의 정의입니다.

typedef struct _OBJECT_DIRECTORY_INFORMATION {
    UNICODE_STRING Name;
    UNICODE_STRING TypeName;
} OBJECT_DIRECTORY_INFORMATION, *POBJECT_DIRECTORY_INFORMATION;

이 함수에는 연결된 가져오기 라이브러리 또는 헤더 파일이 없습니다. LoadLibrary 및 GetProcAddress 함수를 사용하여 호출해야 합니다.

요구 사항

요구 사항	값
DLL	Ntdll.dll

추가 정보

NtOpenDirectoryObject