Функция 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]

Дескриптор объекта каталога.

Buffer [out, optional]

Указатель на буфер, который получает сведения о каталоге. Этот буфер получает одну или несколько OBJECT_DIRECTORY_INFORMATION структур, последняя из которых — NULL, за которой следуют строки, содержащие имена записей каталога. Дополнительные сведения см. в подразделе "Примечания".

Длина [in]

Размер предоставленного пользователем выходного буфера в байтах.

ReturnSingleEntry [in]

Указывает, должна ли функция возвращать только одну запись.

RestartScan [in]

Указывает, следует ли перезапустить проверку или продолжить перечисление с использованием сведений, переданных в параметре Context .

Контекст [вход, выход]

Контекст перечисления.

ReturnLength [out, необязательный]

Указатель на переменную, которая получает длину сведений о каталоге, возвращаемых в выходном буфере, в байтах.

Возвращаемое значение

Функция возвращает STATUS_SUCCESS или состояние ошибки.

Комментарии

Ниже приведено определение структуры OBJECT_DIRECTORY_INFORMATION .

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

У этой функции нет связанной библиотеки импорта или файла заголовка; его необходимо вызвать с помощью функций LoadLibrary и GetProcAddress .

Требования

См. также раздел

NtOpenDirectoryObject