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

Un programme d’installation peut utiliser CryptCATAdminAddCatalog et d’autres fonctions de chiffrement CryptCATAdminXxx pour installer par programmation un fichier catalogue dans la base de données des composants système et des pilotes.

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 façon 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 établir un lien vers 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 vers 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 GUID DRIVER_ACTION_VERIFY. Ce GUID est défini dans Softpub.h.

2. Appelle CryptCATAdminAddCatalog pour ajouter le fichier catalogue au composant système et à la base de données des pilotes. Le programme d’installation fournit le handle au 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 du catalogue pour le fichier catalogue ajouté à la base de données.

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

4. Appelle CryptCATAdminReleaseContext pour publier l’identificateur de ressource du contexte d’administration du catalogue. L'application fournit le descripteur du contexte d'administrateur de catalogue obtenu à l'étape 1.