Fungsi NtOpenDirectoryObject

Artikel
06/13/2023

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

Membuka objek direktori yang ada.

Sintaks

NTSTATUS WINAPI NtOpenDirectoryObject(
  _Out_ PHANDLE            DirectoryHandle,
  _In_  ACCESS_MASK        DesiredAccess,
  _In_  POBJECT_ATTRIBUTES ObjectAttributes
);

Parameter

DirectoryHandle [out]

Handel ke objek direktori yang baru dibuka.

DesiredAccess [in]

ACCESS_MASK yang menentukan akses yang diminta ke objek direktori. Parameter ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
DIRECTORY_QUERY 0x0001	Akses kueri ke objek direktori.
DIRECTORY_TRAVERSE 0x0002	Akses pencarian nama ke objek direktori.
DIRECTORY_CREATE_OBJECT 0x0004	Akses pembuatan nama ke objek direktori.
DIRECTORY_CREATE_SUBDIRECTORY 0x0008	Akses pembuatan subdirektori ke objek direktori.
DIRECTORY_ALL_ACCESS STANDARD_RIGHTS_REQUIRED \| 0xF	Semua hak sebelumnya ditambah STANDARD_RIGHTS_REQUIRED.

ObjectAttributes [in]

Atribut untuk objek direktori. Untuk menginisialisasi struktur OBJECT_ATTRIBUTES , gunakan makro InitializeObjectAttributes . Untuk informasi selengkapnya, lihat dokumentasi untuk item ini dalam dokumentasi untuk WDK.

Nilai kembali

Fungsi mengembalikan STATUS_SUCCESS atau status kesalahan. Kode status yang mungkin mencakup yang berikut ini.

Menampilkan kode	Deskripsi
STATUS_INSUFFICIENT_RESOURCES	Buffer sementara yang diperlukan oleh fungsi ini tidak dapat dialokasikan.
STATUS_INVALID_PARAMETER	Parameter ObjectAttributes yang ditentukan adalah penunjuk NULL , bukan penunjuk yang valid ke struktur OBJECT_ATTRIBUTES , atau beberapa anggota yang ditentukan dalam struktur OBJECT_ATTRIBUTES tidak valid.
STATUS_OBJECT_NAME_INVALID	Parameter ObjectAttributes berisi anggota ObjectName dalam struktur OBJECT_ATTRIBUTES yang tidak valid karena string kosong ditemukan setelah karakter OBJECT_NAME_PATH_SEPARATOR .
STATUS_OBJECT_NAME_NOT_FOUND	Parameter ObjectAttributes berisi anggota ObjectName dalam struktur OBJECT_ATTRIBUTES yang tidak dapat ditemukan.
STATUS_OBJECT_PATH_NOT_FOUND	Parameter ObjectAttributes berisi anggota ObjectName dalam struktur OBJECT_ATTRIBUTES dengan jalur objek yang tidak dapat ditemukan.
STATUS_OBJECT_PATH_SYNTAX_BAD	Parameter ObjectAttributes tidak berisi anggota RootDirectory , tetapi anggota ObjectName dalam struktur OBJECT_ATTRIBUTES adalah string kosong atau tidak berisi karakter OBJECT_NAME_PATH_SEPARATOR . Ini menunjukkan sintaks yang salah untuk jalur objek.

Keterangan

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

Persyaratan

Persyaratan	Nilai
DLL	Ntdll.dll

Lihat juga

NtQueryDirectoryObject

Bagikan melalui