Fungsi TmDereferenceEnlistmentKey (wdm.h)

Artikel
08/08/2023

TmDereferenceEnlistmentKey secara rutin mengurangi jumlah referensi untuk kunci objek pendaftaran tertentu.

Sintaks

NTSTATUS TmDereferenceEnlistmentKey(
  [in]            PKENLISTMENT Enlistment,
  [out, optional] PBOOLEAN     LastReference
);

Parameter

[in] Enlistment

Penunjuk ke objek pendaftaran. Komponen Anda dapat menerima pointer ini sebagai input ke rutinitas panggilan balik ResourceManagerNotification . Atau, komponen Anda dapat memanggil ObReferenceObjectByHandle dan menyediakan handel objek yang disediakan panggilan sebelumnya ke ZwCreateEnlistment, TmCreateEnlistment, atau ZwOpenEnlistment .

[out, optional] LastReference

Penunjuk ke variabel berjenis BOOLEAN. Variabel ini menerima TRUE jika jumlah referensi adalah nol setelah TmDereferenceEnlistmentKey menguranginya. Jika tidak, variabel menerima FALSE.

Mengembalikan nilai

TmDereferenceEnlistmentKey mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, rutinitas ini mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_UNSUCCESSFUL	Jumlah referensi objek pendaftaran yang ditentukan adalah nol dan tidak dapat direkrut.

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Rutinitas TmReferenceEnlistmentKey meningkatkan jumlah referensi untuk kunci objek pendaftaran, dan rutin TmDereferenceEnlistmentKey mengurangi hitungan.

Untuk informasi tentang kapan harus menggunakan rutinitas TmXxx KTM alih-alih rutinitas ZwXxx , lihat Menggunakan Rutinitas TmXxx.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi sistem operasi yang lebih baru.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL