Compartilhar via

Instalando um arquivo de catálogo usando CryptCATAdminAddCatalog

  • Artigo

Um programa de instalação pode usar o CryptCATAdminAddCatalog e outras funções de criptografia CryptCATAdminXxx para instalar programaticamente um arquivo de catálogo no componente do sistema e no banco de dados de driver.

O programa de instalação deve usar o Microsoft Windows Software Development Kit (SDK) para Windows 7 e .NET Framework 4.0 da seguinte maneira:

  • Os arquivos de origem do programa de instalação devem incluir os seguintes arquivos de cabeçalho (.h):

    • Mscat.h, que define os protótipos e estruturas para as várias funções CryptCATAdminXxx .
    • Softpub.h, que define as várias estruturas de dados e GUIDs que são usadas pelas funções CryptCATAdminXxx .

  • O programa de instalação deve ser vinculado ao Wintrust.lib.

Para usar essas funções de criptografia CryptCATAdminXxx , um programa de instalação faz o seguinte:

  1. Chama CryptCATAdminAcquireContext para obter um identificador para um contexto de administrador de catálogo. O aplicativo identifica o subsistema definindo o parâmetro de entrada pgSubsystem como um ponteiro para o guid DRIVER_ACTION_VERIFY. Esse GUID é definido em Softpub.h.

  2. Chama CryptCATAdminAddCatalog para adicionar o arquivo de catálogo ao componente do sistema e ao banco de dados de driver. O programa de instalação fornece o identificador para o contexto de administrador do catálogo que foi obtido na etapa 1, um ponteiro para o caminho totalmente qualificado do arquivo de catálogo e um ponteiro para o nome do arquivo de catálogo que a função usa para instalar uma cópia do arquivo de catálogo no banco de dados. A função retorna um identificador para o contexto de informações de catálogo para o arquivo de catálogo que foi adicionado ao banco de dados.

  3. Chama CryptCATAdminReleaseCatalogContext para liberar o identificador para o contexto de informações do catálogo do arquivo de catálogo. O programa de instalação fornece o identificador para o contexto de administrador do catálogo que foi obtido na etapa 1 e o identificador para o contexto de informações do catálogo que foi retornado na etapa 2.

  4. Chama CryptCATAdminReleaseContext para liberar o identificador para o contexto de administrador do catálogo. O aplicativo fornece o identificador para o contexto de administrador do catálogo que foi obtido na etapa 1.