Função NtQueryDirectoryObject

[Essa função pode estar alterada ou indisponível no futuro.]

Recupera informações sobre o objeto de diretório especificado.

Sintaxe

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]

Um identificador para o objeto de diretório.

Buffer [out, opcional]

Um ponteiro para um buffer que recebe as informações de diretório. Esse buffer recebe uma ou mais estruturas OBJECT_DIRECTORY_INFORMATION , sendo a última NULL, seguida por cadeias de caracteres que contêm os nomes das entradas de diretório. Para obter mais informações, consulte Comentários.

Comprimento [in]

O tamanho do buffer de saída fornecido pelo usuário, em bytes.

ReturnSingleEntry [in]

Indica se a função deve retornar apenas uma única entrada.

RestartScan [in]

Indica se é necessário reiniciar a verificação ou continuar a enumeração usando as informações passadas no parâmetro Context .

Contexto [in, out]

O contexto de enumeração.

ReturnLength [out, opcional]

Um ponteiro para uma variável que recebe o comprimento das informações de diretório retornadas no buffer de saída, em bytes.

Valor retornado

A função retorna STATUS_SUCCESS ou um erro status.

Comentários

Veja a seguir a definição da estrutura OBJECT_DIRECTORY_INFORMATION .

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

Essa função não tem biblioteca de importação ou arquivo de cabeçalho associado; você deve chamá-lo usando as funções LoadLibrary e GetProcAddress .

Requisitos

Requisito	Valor
DLL	Ntdll.dll

Confira também

NtOpenDirectoryObject