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

  • Artículo

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 del controlador.

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 distintas estructuras de datos y GUID que usan las funciones CryptCATAdminXxx .

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

Para usar estas funciones criptográficas CryptCATAdminXxx , un programa de instalación hace lo siguiente:

  1. Llama a CryptCATAdminAcquireContext para obtener un identificador a un contexto de administrador del catálogo. 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 del controlador. El programa de instalación proporciona el identificador al 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 al 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 identificador al contexto de administrador del catálogo que se obtuvo en el paso 1 y el identificador para el contexto de información del catálogo que se devolvió en el paso 2.

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