Contextinformatie opgeven

De configuratiemanager biedt verschillende manieren waarop filtering-stuurprogramma's voor het register contextinformatie kunnen toewijzen aan registerbewerkingen. Een stuurprogramma voor registerfilters kan het volgende doen:

• Contextinformatie toewijzen aan de RegistryCallback-routine .

  Wanneer uw stuurprogramma CmRegisterCallback of CmRegisterCallbackEx aanroept om zich te registreren voor melding van een registerbewerking, kan het stuurprogramma een door het stuurprogramma gedefinieerde contextwaarde opgeven. De Configuration Manager geeft deze contextwaarde door aan de RegistryCallback-routine van het stuurprogramma telkens wanneer de configuration manager de routine aanroept.

  Deze contextinformatie wordt ondersteund vanaf Windows XP.

• Contextinformatie toewijzen aan een registerbewerking.

  Stuurprogramma's kunnen bewerkingsspecifieke contextinformatie opslaan in het CallContext-lid van elke REG_XXX_KEY_INFORMATION structuur die de RegistryCallback-routine van het stuurprogramma ontvangt. Als uw stuurprogramma zowel een voorafgaande melding als een postmelding ontvangt voor een registerbewerking, bevat de REG_POST_OPERATION_INFORMATION structuur een aanwijzer naar de juiste structuur voor voorafgaande meldingen. Wanneer een RegistryCallback-routine een REG_POST_OPERATION_INFORMATION structuur ontvangt, komt het CallContext-lid van die structuur overeen met het CallContext-lid van de structuur voor meldingen.

  Het CallContext-lid van deze structuren is beschikbaar vanaf Windows Vista.

• Contextinformatie toewijzen aan een registersleutelobject.

  Een RegistryCallback-routine kan contextinformatie toewijzen aan een bepaald registersleutelobject. Als de RegistryCallback-routineCmSetCallbackObjectContext aanroept om contextinformatie toe te wijzen aan een sleutelobject, bevatten volgende voorafgaande meldingen en postmeldingen voor alle bewerkingen op het object de contextwaarde in het ObjectContext-lid van elke REG_XXX_KEY_INFORMATION structuur. Als een stuurprogramma meerdere RegistryCallback-routines biedt, kan het stuurprogramma verschillende contextinformatie toewijzen voor elke routine, voor één registersleutelobject.

  Als een stuurprogramma CmSetCallbackObjectContext heeft aangeroepen, ontvangt de RegistryCallback-routine van het stuurprogramma een RegNtCallbackObjectContextCleanup-melding nadat de ingang van het sleutelobject is gesloten. Als reactie op deze melding moet de routine alle resources vrijgeven die zijn toegewezen voor de context van het object. Wanneer de parameter Argument1 voor de RegistryCallback-routineRegNtCallbackObjectContextCleanup is, is de parameter Argument2 een aanwijzer naar een REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION structuur die een aanwijzer naar de context bevat.

  De CmSetCallbackObjectContext-routine en RegNtCallbackObjectContextCleanup-melding zijn beschikbaar vanaf Windows Vista.