Menentukan Informasi Konteks

Manajer konfigurasi menyediakan beberapa cara untuk driver pemfilteran registri untuk menetapkan informasi konteks ke operasi registri. Driver pemfilteran registri dapat:

• Tetapkan informasi konteks ke rutinitas RegistryCallback .

  Ketika driver Anda memanggil CmRegisterCallback atau CmRegisterCallbackEx untuk mendaftar untuk pemberitahuan operasi registri, driver dapat menentukan nilai konteks yang ditentukan driver. Manajer konfigurasi meneruskan nilai konteks ini ke rutinitas RegistryCallback driver setiap kali manajer konfigurasi memanggil rutinitas.

  Informasi konteks ini didukung dimulai dengan Windows XP.

• Tetapkan informasi konteks ke operasi registri.

  Driver dapat menyimpan informasi konteks khusus operasi di anggota CallContext dari setiap struktur REG_XXX_KEY_INFORMATION yang diterima rutinitas RegistryCallback driver. Jika driver Anda menerima pra-pemberitahuan dan pasca-pemberitahuan untuk operasi registri, struktur REG_POST_OPERATION_INFORMATION berisi penunjuk ke struktur pra-pemberitahuan yang sesuai. Ketika rutinitas RegistryCallback menerima struktur REG_POST_OPERATION_INFORMATION , anggota CallContext dari struktur tersebut cocok dengan anggota CallContext dari struktur pra-pemberitahuan.

  Anggota CallContext dari struktur ini tersedia dimulai dengan Windows Vista.

• Tetapkan informasi konteks ke objek kunci registri.

  Rutinitas RegistryCallback dapat menetapkan informasi konteks ke objek kunci registri tertentu. Jika registryCallback rutin memanggil CmSetCallbackObjectContext untuk menetapkan informasi konteks ke objek kunci, pra-pemberitahuan berikutnya dan pasca-pemberitahuan untuk semua operasi pada objek akan menyertakan nilai konteks dalam anggota ObjectContext dari setiap struktur REG_XXX_KEY_INFORMATION . Jika driver menyediakan beberapa rutinitas RegistryCallback , driver dapat menetapkan informasi konteks yang berbeda untuk setiap rutinitas, untuk satu objek kunci registri.

  Jika driver telah disebut CmSetCallbackObjectContext, rutinitas RegistryCallback driver akan menerima pemberitahuan RegNtCallbackObjectContextCleanup setelah handel objek kunci ditutup. Menanggapi pemberitahuan ini, rutinitas harus merilis sumber daya apa pun yang dialokasikan untuk konteks objek. Ketika parameter Argumen1 ke rutinitas RegistryCallback adalah RegNtCallbackObjectContextCleanup, parameter Argument2 adalah penunjuk ke struktur REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION yang berisi penunjuk ke konteks.

  CmSetCallbackObjectContext rutin dan pemberitahuan RegNtCallbackObjectContextCleanup tersedia dimulai dengan Windows Vista.