Een catalogusbestand installeren met behulp van CryptCATAdminAddCatalog

Een installatieprogramma kan de CryptCATAdminAddCatalog en andere CryptCATAdminXxx-cryptografiefuncties gebruiken om programmatisch een catalogusbestand te installeren in de systeemonderdeel- en stuurprogrammadatabase.

Het installatieprogramma moet op de volgende manier gebruikmaken van de Microsoft Windows Software Development Kit (SDK) voor Windows 7 en .NET Framework 4.0:

• De bronbestanden van het installatieprogramma moeten de volgende headerbestanden (.h) bevatten:

  • Mscat.h, waarmee de prototypen en structuren voor de verschillende functies CryptCATAdminXxx worden gedefinieerd.
  • Softpub.h, waarmee de verschillende gegevensstructuren en GUID's worden gedefinieerd die worden gebruikt door de functies CryptCATAdminXxx .

• Het installatieprogramma moet koppelen met Wintrust.lib.

Als u deze cryptografiefuncties CryptCATAdminXxx wilt gebruiken, doet een installatieprogramma het volgende:

1. Roept CryptCATAdminAcquireContext aan om een handle te verkrijgen voor een catalogusbeheerderscontext. De toepassing identificeert het subsysteem door de parameter pgSubsystem-invoer in te stellen op een aanwijzer naar de GUID-DRIVER_ACTION_VERIFY. Deze GUID is gedefinieerd in Softpub.h.

2. Roept CryptCATAdminAddCatalog aan om het catalogusbestand toe te voegen aan de systeemonderdeel- en stuurprogrammadatabase. Het installatieprogramma levert de handle aan de context van de catalogusbeheerder die is verkregen in stap 1, een aanwijzer naar het volledig gekwalificeerde pad van het catalogusbestand en een aanwijzer naar de naam van het catalogusbestand dat door de functie wordt gebruikt om een kopie van het catalogusbestand in de database te installeren. De functie retourneert een handle naar de catalogusinformatiecontext voor het catalogusbestand dat is toegevoegd aan de database.

3. Roept CryptCATAdminReleaseCatalogContext aan om de handle naar de catalogusinformatiecontext voor het catalogusbestand vrij te geven. Het installatieprogramma levert de handle aan de context van de catalogusbeheerder die is verkregen in stap 1 en de handle voor de catalogusinformatiecontext die is geretourneerd in stap 2.

4. Roept CryptCATAdminReleaseContext aan om de handle naar de context van de catalogusbeheerder vrij te geven. De toepassing levert de handle aan de context van de catalogusbeheerder die is verkregen in stap 1.