Fungsi ZwMakeTemporaryObject (wdm.h)
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
Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli