Fungsi NtOpenResourceManager (wdm.h)
Rutinitas ZwOpenResourceManager mengembalikan handel ke objek manajer sumber daya yang ada.
Sintaks
__kernel_entry NTSYSCALLAPI NTSTATUS NtOpenResourceManager(
[out] PHANDLE ResourceManagerHandle,
[in] ACCESS_MASK DesiredAccess,
[in] HANDLE TmHandle,
[in] LPGUID ResourceManagerGuid,
[in, optional] POBJECT_ATTRIBUTES ObjectAttributes
);
Parameter
[out] ResourceManagerHandle
Penunjuk ke variabel yang dialokasikan penelepon yang menerima handel manajer sumber daya jika panggilan ke ZwOpenResourceManager berhasil.
[in] DesiredAccess
Nilai ACCESS_MASK yang menentukan akses pemanggil yang diminta ke objek manajer sumber daya. Untuk informasi selengkapnya tentang cara menentukan parameter ini, lihat parameter DesiredAccess dari ZwCreateResourceManager. Parameter ini tidak boleh nol.
[in] TmHandle
Handel ke objek manajer transaksi yang diperoleh oleh panggilan sebelumnya ke ZwCreateTransactionManager atau ZwOpenTransactionManager.
[in] ResourceManagerGuid
Penunjuk ke GUID yang mengidentifikasi manajer sumber daya untuk dibuka.
[in, optional] ObjectAttributes
Penunjuk ke struktur OBJECT_ATTRIBUTES yang menentukan atribut objek. Gunakan rutinitas InitializeObjectAttributes untuk menginisialisasi struktur ini, tetapi tentukan hanya parameter InitializedAttributes dan Attributes rutin tersebut. Jika pemanggil tidak berjalan dalam konteks utas sistem, pemanggil harus mengatur bendera OBJ_KERNEL_HANDLE di parameter Atribut. Parameter ini bersifat opsional dan dapat berupa NULL.
Nilai kembali
ZwOpenResourceManager mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, rutinitas ini mungkin mengembalikan salah satu nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
|
Handel yang ditentukan TmHandle bukan handel ke objek transaksi. |
|
Handel yang ditentukan TmHandle tidak valid. |
|
Pemanggil tidak memiliki akses yang sesuai ke objek manajer transaksi yang ditentukan. |
|
Parameter DesiredAccess adalah nol atau parameter ResourceManagerGuid tidak valid. |
|
Manajer sumber daya yang ditentukan tidak dapat ditemukan. |
|
Manajer transaksi yang ditentukan tidak online. |
Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.
Keterangan
Biasanya, komponen TPS memanggil ZwOpenResourceManager setelah menerima GUID pendaftaran dari komponen TPS lain yang sebelumnya disebut ZwCreateResourceManager. Sebagian besar desain TPS tidak memerlukan panggilan ZwOpenResourceManager.
Manajer sumber daya yang memanggil ZwOpenResourceManager akhirnya harus memanggil ZwClose untuk menutup handel objek.
Untuk informasi selengkapnya tentang ZwOpenResourceManager, lihat Objek KTM.
NtOpenResourceManager dan ZwOpenResourceManager adalah dua versi dari rutinitas Windows Native System Services yang sama.
Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinitas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menafsirkan 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, Ntifs.h) |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
Aturan kepatuhan DDI | HwStorPortProhibitedDDIs, PowerIrpDDis |
Lihat juga
Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli