Fungsi ZwOpenResourceManager (wdm.h)

Artikel
02/29/2024

Rutinitas ZwOpenResourceManager mengembalikan handel ke objek manajer sumber daya yang ada.

Sintaks

NTSYSCALLAPI NTSTATUS ZwOpenResourceManager(
  [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 pemanggil yang menerima handel manajer sumber daya jika panggilan ke ZwOpenResourceManager berhasil.

[in] DesiredAccess

Nilai ACCESS_MASK yang menentukan akses yang diminta penelepon ke objek resource manager. 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 hanya tentukan parameter InitializedAttributes dan Attributes rutin tersebut. Jika pemanggil tidak berjalan dalam konteks utas sistem, pemanggil harus mengatur bendera OBJ_KERNEL_HANDLE dalam 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
STATUS_OBJECT_TYPE_MISMATCH	Handel yang ditentukan TmHandle bukan handel ke objek transaksi.
STATUS_INVALID_HANDLE	Handel yang ditentukan TmHandle tidak valid.
STATUS_ACCESS_DENIED	Pemanggil tidak memiliki akses yang sesuai ke objek manajer transaksi yang ditentukan.
STATUS_INVALID_PARAMETER	Parameter DesiredAccess adalah nol atau parameter ResourceManagerGuid tidak valid.
STATUS_RESOURCEMANAGER_NOT_FOUND	Manajer sumber daya yang ditentukan tidak dapat ditemukan.
STATUS_TRANSACTIONMANAGER_NOT_ONLINE	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 Layanan Sistem Asli Windows 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 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, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)