Partager via


Installation d’un fichier catalogue à l’aide de CryptCATAdminAddCatalog

Un programme d’installation peut utiliser les fonctions de chiffrement CryptCATAdminAddCatalog et d’autres CryptCATAdminXxx pour installer par programme un fichier catalogue dans la base de données du composant système et du pilote.

Le programme d’installation doit utiliser le Kit de développement logiciel (SDK) Microsoft Windows pour Windows 7 et .NET Framework 4.0 de la manière suivante :

  • Les fichiers sources du programme d’installation doivent inclure les fichiers d’en-tête (.h) suivants :

    • Mscat.h, qui définit les prototypes et les structures des différentes fonctions CryptCATAdminXxx .
    • Softpub.h, qui définit les différentes structures de données et GUID utilisés par les fonctions CryptCATAdminXxx .
  • Le programme d’installation doit être lié à Wintrust.lib.

Pour utiliser ces fonctions de chiffrement CryptCATAdminXxx , un programme d’installation effectue les opérations suivantes :

  1. Appelle CryptCATAdminAcquireContext pour obtenir un handle dans un contexte d’administrateur de catalogue. L’application identifie le sous-système en définissant le paramètre d’entrée pgSubsystem sur un pointeur vers le DRIVER_ACTION_VERIFY GUID. Ce GUID est défini dans Softpub.h.

  2. Appelle CryptCATAdminAddCatalog pour ajouter le fichier catalogue à la base de données du composant système et du pilote. Le programme d’installation fournit le handle vers le contexte d’administrateur de catalogue obtenu à l’étape 1, un pointeur vers le chemin complet du fichier catalogue et un pointeur vers le nom du fichier catalogue que la fonction utilise pour installer une copie du fichier catalogue dans la base de données. La fonction retourne un handle au contexte d’informations de catalogue pour le fichier catalogue ajouté à la base de données.

  3. Appelle CryptCATAdminReleaseCatalogContext pour libérer le handle dans le contexte d’informations du catalogue pour le fichier catalogue. Le programme d’installation fournit le handle au contexte d’administrateur de catalogue obtenu à l’étape 1 et le handle au contexte d’informations du catalogue retourné à l’étape 2.

  4. Appelle CryptCATAdminReleaseContext pour libérer le handle dans le contexte administrateur du catalogue. L’application fournit le handle au contexte d’administrateur de catalogue obtenu à l’étape 1.