Función NtQueryDirectoryObject

[Esta función puede modificarse o no estar disponible en el futuro.

Recupera información sobre el objeto de directorio especificado.

Sintaxis

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
);

Parámetros

DirectoryHandle [in]

Identificador del objeto de directorio.

Búfer [out, opcional]

Puntero a un búfer que recibe la información del directorio. Este búfer recibe una o varias estructuras de OBJECT_DIRECTORY_INFORMATION , la última que es NULL, seguida de cadenas que contienen los nombres de las entradas del directorio. Para obtener más información, vea la sección Comentarios.

Longitud [in]

Tamaño del búfer de salida proporcionado por el usuario, en bytes.

ReturnSingleEntry [in]

Indica si la función debe devolver solo una sola entrada.

RestartScan [in]

Indica si se debe reiniciar el examen o continuar la enumeración con la información pasada en el parámetro Context .

Contexto [in, out]

Contexto de enumeración.

ReturnLength [out, opcional]

Puntero a una variable que recibe la longitud de la información del directorio devuelta en el búfer de salida, en bytes.

Valor devuelto

La función devuelve STATUS_SUCCESS o un estado de error.

Comentarios

A continuación se muestra la definición de la estructura OBJECT_DIRECTORY_INFORMATION .

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

Esta función no tiene ningún archivo de encabezado o biblioteca de importación asociado; Debe llamarlo mediante las funciones LoadLibrary y GetProcAddress .

Requisitos

Consulte también

NtOpenDirectoryObject