Fungsi ZwMakeTemporaryObject (wdm.h)

  • Artikel

Rutinitas ZwMakeTemporaryObject mengubah atribut objek untuk membuatnya sementara.

Sintaks

NTSYSAPI NTSTATUS ZwMakeTemporaryObject(
  [in] HANDLE Handle
);

Parameter

[in] Handle

Tangani ke objek dari jenis apa pun.

Nilai kembali

ZwMakeTemporaryObject mengembalikan STATUS_SUCCESS pada keberhasilan, atau kode kesalahan NTSTATUS yang sesuai pada kegagalan.

Keterangan

ZwMakeTemporaryObject adalah rutinitas generik yang beroperasi pada semua jenis objek.

Objek bersifat permanen jika dibuat dengan atribut objek OBJ_PERMANENT yang ditentukan. (Untuk informasi selengkapnya tentang atribut objek, lihat InitializeObjectAttributes.) Objek permanen dibuat dengan jumlah referensi 1, sehingga tidak dihapus saat driver mendereferensikannya.

Objek bersifat sementara jika tidak permanen. ZwMakeTemporaryObject mengubah objek yang ditentukan menjadi objek sementara. Jika objek sudah bersifat sementara, rutinitas ini tidak melakukan apa-apa.

Objek sementara memiliki nama hanya selama jumlah handelnya lebih besar dari nol. Ketika jumlah handel mencapai nol, sistem menghapus nama objek dan menyesuaikan jumlah penunjuk objek dengan tepat.

Jika panggilan ke fungsi ini terjadi dalam mode pengguna, Anda harus menggunakan nama "NtMakeTemporaryObject" alih-alih "ZwMakeTemporaryObject".

Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinItas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menginterpretasikan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi NtXxx dan ZwXxx dari rutinitas, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Lihat juga

InitializeObjectAttributes

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwClose

ZwCreateDirectoryObject

ZwCreateFile