Fungsi CmCallbackGetKeyObjectID (wdm.h)

Artikel
02/27/2024

Rutinitas CmCallbackGetKeyObjectID mengambil pengidentifikasi unik dan nama objek yang terkait dengan objek kunci registri tertentu.

Dimulai dengan Windows 8, driver filter registri harus memanggil rutinitas CmCallbackGetKeyObjectIDEx alih-alih CmCallbackGetKeyObjectID. Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.

Sintaks

NTSTATUS CmCallbackGetKeyObjectID(
  [in]            PLARGE_INTEGER   Cookie,
  [in]            PVOID            Object,
  [out, optional] PULONG_PTR       ObjectID,
  [out, optional] PCUNICODE_STRING *ObjectName
);

Parameter

[in] Cookie

Nilai cookie yang sebelumnya diperoleh driver dengan memanggil rutinitas CmRegisterCallback atau CmRegisterCallbackEx .

[in] Object

Nilai pointer yang diterima rutinitas panggilan balik RegistryCallback driver di anggota Objek dari salah satu struktur REG_XXX_KEY_INFORMATION .

Peringatan

Dalam keadaan tertentu, struktur pemberitahuan panggilan balik registri mungkin berisi penunjuk objek non-NULL yang tidak valid. Driver pemfilteran registri tidak boleh meneruskan penunjuk tersebut ke rutinitas ini. Untuk informasi selengkapnya, lihat Penunjuk Objek Kunci Tidak Valid di Pemberitahuan Registri.

[out, optional] ObjectID

Penunjuk ke lokasi yang menerima penunjuk ke pengidentifikasi unik yang mewakili kunci registri yang ditentukan Objek . Parameter ini bersifat opsional dan dapat berupa NULL.

[out, optional] ObjectName

Penunjuk ke lokasi yang menerima penunjuk ke struktur UNICODE_STRING . Struktur ini berisi nama objek objek kunci registri yang ditentukan Objek . Nama objek sebenarnya adalah nama jalur lengkap dari kunci registri yang diwakili objek. Penelepon tidak boleh menulis ke struktur UNICODE_STRING ini atau membebaskannya. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

CmCallbackGetKeyObjectID mengembalikan STATUS_SUCCESS jika operasi berhasil. Kemungkinan nilai pengembalian kesalahan mencakup kode status berikut.

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	Parameter Cookie atau Objek tidak valid.

Keterangan

Rutinitas CmCallbackGetKeyObjectID tersedia dimulai dengan Windows Vista. Versi yang ditingkatkan dari rutinitas ini, CmCallbackGetKeyObjectIDEx, tersedia dimulai dengan Windows 8. Driver yang hanya berjalan di versi Windows Windows 8 dan yang lebih baru harus memanggil CmCallbackGetKeyObjectIDEx alih-alih CmCallbackGetKeyObjectID.

Driver dapat menggunakan CmCallbackGetKeyObjectID untuk mendapatkan pengidentifikasi kunci registri, nama objek, atau keduanya, dengan menyediakan nilai non-NULL untuk parameter ObjectID atau ObjectName .

Setelah driver mendapatkan pengidentifikasi atau nama, pengidentifikasi atau nama valid sampai rutinitas RegistryCallback driver menerima pra-pemberitahuan penutupan handel.

Pengandar tidak boleh mengubah nama objek.

Jika dua objek kunci registri mewakili kunci registri yang sama, pengidentifikasi kunci untuk kedua objek identik.

Untuk informasi selengkapnya tentang CmCallbackGetKeyObjectID dan operasi pemfilteran registri, lihat Memfilter Panggilan Registri.