Instalación de un archivo de catálogo mediante CryptCATAdminAddCatalog

Un programa de instalación puede usar CryptCATAdminAddCatalog y otras funciones de criptografía CryptCATAdminXxx para instalar mediante programación un archivo de catálogo en el componente del sistema y la base de datos de controladores.

El programa de instalación debe usar el kit de desarrollo de software (SDK) de Microsoft Windows para Windows 7 y .NET Framework 4.0 de la siguiente manera:

• Los archivos de origen del programa de instalación deben incluir los siguientes archivos de encabezado (.h):

  • Mscat.h, que define los prototipos y estructuras de las distintas funciones CryptCATAdminXxx .
  • Softpub.h, que define las diversas estructuras de datos y GUID que usan las funciones CryptCATAdminXxx .

• El programa de instalación debe vincularse a Wintrust.lib.

Para usar estas funciones de criptografía CryptCATAdminXxx , un programa de instalación hace lo siguiente:

1. Llama a CryptCATAdminAcquireContext para obtener un identificador para un contexto de administrador de catálogos. La aplicación identifica el subsistema estableciendo el parámetro de entrada pgSubsystem en un puntero al guid DRIVER_ACTION_VERIFY. Este GUID se define en Softpub.h.

2. Llama a CryptCATAdminAddCatalog para agregar el archivo de catálogo al componente del sistema y a la base de datos de controladores. El programa de instalación proporciona el identificador del contexto de administrador del catálogo que se obtuvo en el paso 1, un puntero a la ruta de acceso completa del archivo de catálogo y un puntero al nombre del archivo de catálogo que la función usa para instalar una copia del archivo de catálogo en la base de datos. La función devuelve un identificador del contexto de información del catálogo para el archivo de catálogo que se agregó a la base de datos.

3. Llama a CryptCATAdminReleaseCatalogContext para liberar el identificador al contexto de información del catálogo para el archivo de catálogo. El programa de instalación proporciona el descriptor al contexto de administrador del catálogo que se obtuvo en el paso 1 y el descriptor del contexto de información del catálogo que se devolvió en el paso 2.

4. Llama a CryptCATAdminReleaseContext para liberar el identificador del contexto del administrador de catálogos. La aplicación proporciona el descriptor al contexto del administrador del catálogo que se obtuvo en el paso 1.