Fungsi NtQueryDirectoryObject

[Fungsi ini dapat diubah atau tidak tersedia di masa mendatang.]

Mengambil informasi tentang objek direktori yang ditentukan.

Sintaks

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

Parameter

DirectoryHandle [in]

Handel ke objek direktori.

Buffer [keluar, opsional]

Penunjuk ke buffer yang menerima informasi direktori. Buffer ini menerima satu atau beberapa struktur OBJECT_DIRECTORY_INFORMATION , yang terakhir adalah NULL, diikuti oleh string yang berisi nama entri direktori. Untuk informasi selengkapnya, lihat Keterangan.

Panjang [in]

Ukuran buffer output yang disediakan pengguna, dalam byte.

ReturnSingleEntry [in]

Menunjukkan apakah fungsi harus mengembalikan hanya satu entri.

RestartScan [in]

Menunjukkan apakah akan memulai ulang pemindaian atau melanjutkan enumerasi menggunakan informasi yang diteruskan dalam parameter Konteks .

Konteks [masuk, keluar]

Konteks enumerasi.

ReturnLength [keluar, opsional]

Penunjuk ke variabel yang menerima panjang informasi direktori yang dikembalikan dalam buffer output, dalam byte.

Nilai kembali

Fungsi mengembalikan STATUS_SUCCESS atau status kesalahan.

Keterangan

Berikut ini adalah definisi struktur OBJECT_DIRECTORY_INFORMATION .

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

Fungsi ini tidak memiliki pustaka impor atau file header terkait; Anda harus memanggilnya menggunakan fungsi LoadLibrary dan GetProcAddress .

Persyaratan

Lihat juga

NtOpenDirectoryObject