Fungsi ZwSinglePhaseReject (wdm.h)

  • Artikel

Rutinitas ZwSinglePhaseReject menginformasikan KTM bahwa manajer sumber daya panggilan tidak akan mendukung operasi penerapan fase tunggal untuk pendaftaran tertentu.

Sintaks

NTSYSCALLAPI NTSTATUS ZwSinglePhaseReject(
  [in]           HANDLE         EnlistmentHandle,
  [in, optional] PLARGE_INTEGER TmVirtualClock
);

Parameter

[in] EnlistmentHandle

Handel ke objek pendaftaran yang diperoleh oleh panggilan sebelumnya ke ZwCreateEnlistment atau ZwOpenEnlistment. Handel harus memiliki akses ENLISTMENT_SUBORDINATE_RIGHTS ke objek .

[in, optional] TmVirtualClock

Penunjuk ke nilai jam virtual. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

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

Menampilkan kode Deskripsi
STATUS_OBJECT_TYPE_MISMATCH
 Handel yang ditentukan bukan handel ke objek pendaftaran.
STATUS_INVALID_HANDLE
 Handel objek tidak valid.
STATUS_TRANSACTION_NOT_REQUESTED
 Transaksi atau pendaftarannya tidak dalam status yang benar.
STATUS_ACCESS_DENIED
 Pemanggil tidak memiliki akses yang sesuai ke objek pendaftaran.
 

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Manajer sumber daya dapat memanggil ZwSinglePhaseReject saat menerima pemberitahuan TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT.

Untuk informasi selengkapnya tentang ZwSinglePhaseReject, lihat Menangani Operasi Penerapan.

NtSinglePhaseReject dan ZwSinglePhaseReject adalah dua versi dari rutinitas Windows Native System Services yang sama. Rutinitas NtSinglePhaseReject di kernel Windows tidak dapat diakses langsung oleh driver mode kernel. Namun, driver mode kernel dapat mengakses rutinitas ini secara tidak langsung dengan memanggil rutinitas ZwSinglePhaseReject .

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
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 PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Lihat juga

TmSinglePhaseReject

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwCreateEnlistment

ZwOpenEnlistment