Edit

Installing a Catalog File by using CryptCATAdminAddCatalog

  • Article

An installation program can use the CryptCATAdminAddCatalog and other CryptCATAdminXxx cryptography functions to programmatically install a catalog file in the system component and driver database.

The installation program must use the Microsoft Windows Software Development Kit (SDK) for Windows 7 and .NET Framework 4.0 in the following way:

  • The source files of the installation program must include the following header (.h) files:

    • Mscat.h, which defines the prototypes and structures for the various CryptCATAdminXxx functions.
    • Softpub.h, which defines the various data structures and GUIDs that are used by the CryptCATAdminXxx functions.

  • The installation program must link to Wintrust.lib.

To use these CryptCATAdminXxx cryptography functions, an installation program does the following:

  1. Calls CryptCATAdminAcquireContext to obtain a handle to a catalog administrator context. The application identifies the subsystem by setting the pgSubsystem input parameter to a pointer to the GUID DRIVER_ACTION_VERIFY. This GUID is defined in Softpub.h.

  2. Calls CryptCATAdminAddCatalog to add the catalog file to the system component and driver database. The installation program supplies the handle to the catalog administrator context that was obtained in step 1, a pointer to the fully qualified path of the catalog file, and a pointer to the name of the catalog file that the function uses to install a copy of the catalog file in the database. The function returns a handle to the catalog information context for the catalog file that was added to the database.

  3. Calls CryptCATAdminReleaseCatalogContext to release the handle to the catalog information context for the catalog file. The installation program supplies the handle to the catalog administrator context that was obtained in step 1 and the handle to the catalog information context that was returned in step 2.

  4. Calls CryptCATAdminReleaseContext to release the handle to the catalog administrator context. The application supplies the handle to the catalog administrator context that was obtained in step 1.