Installieren einer Katalogdatei mithilfe von CryptCATAdminAddCatalog
Ein Installationsprogramm kann die Kryptografiefunktionen CryptCATAdminAddCatalog und andere CryptCATAdmin Xxx-Kryptografiefunktionen verwenden, um eine Katalogdatei in der Systemkomponente und Treiberdatenbank programmgesteuert zu installieren.
Das Installationsprogramm muss das Microsoft Windows Software Development Kit (SDK) für Windows 7 und .NET Framework 4.0 wie folgt verwenden:
Die Quelldateien des Installationsprogramms müssen die folgenden Headerdateien (.h) enthalten:
- Mscat.h, die die Prototypen und Strukturen für die verschiedenen Xxx-Funktionen von CryptCATAdmin definiert.
- Softpub.h, die die verschiedenen Datenstrukturen und GUIDs definiert, die von den Xxx-Funktionen CryptCATAdmin verwendet werden.
Das Installationsprogramm muss mit Wintrust.lib verknüpft werden.
Um diese CryptCATAdmin Xxx-Kryptografiefunktionen zu verwenden, führt ein Installationsprogramm Folgendes aus:
Ruft CryptCATAdminAcquireContext auf, um ein Handle für einen Katalogadministratorkontext abzurufen. Die Anwendung identifiziert das Subsystem, indem sie den Eingabeparameter pgSubsystem auf einen Zeiger auf die GUID DRIVER_ACTION_VERIFY. Diese GUID ist in Softpub.h definiert.
Ruft CryptCATAdminAddCatalog auf, um die Katalogdatei der Systemkomponente und treiberdatenbank hinzuzufügen. Das Installationsprogramm stellt das Handle für den In Schritt 1 abgerufenen Katalogadministratorkontext, einen Zeiger auf den vollqualifizierten Pfad der Katalogdatei und einen Zeiger auf den Namen der Katalogdatei bereit, die die Funktion zum Installieren einer Kopie der Katalogdatei in der Datenbank verwendet. Die Funktion gibt ein Handle für den Kataloginformationskontext für die Katalogdatei zurück, die der Datenbank hinzugefügt wurde.
Ruft CryptCATAdminReleaseCatalogContext auf, um das Handle für den Kataloginformationskontext für die Katalogdatei freizugeben. Das Installationsprogramm stellt das Handle für den In Schritt 1 abgerufenen Katalogadministratorkontext und das Handle für den In Schritt 2 zurückgegebenen Kataloginformationskontext bereit.
Ruft CryptCATAdminReleaseContext auf, um das Handle für den Katalogadministratorkontext freizugeben. Die Anwendung stellt das Handle für den Katalogadministratorkontext bereit, der in Schritt 1 abgerufen wurde.