Fonction CryptCATAdminAddCatalog (mscat.h)

  • Article

[La fonction CryptCATAdminAddCatalog est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

La fonction CryptCATAdminAddCatalog ajoute un catalogue à la base de données du catalogue. La base de données de catalogue est un index qui associe des hachages de fichiers aux catalogues qui les contiennent. Il permet d’accélérer l’identification des catalogues lors de la vérification de la signature du fichier. Cette fonction est le seul moyen pris en charge pour ajouter des catalogues par programmation à la base de données de catalogue Windows. La fonction n’a pas de bibliothèque d’importation associée. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir un lien dynamique vers Wintrust.dll.

Syntaxe

HCATINFO CryptCATAdminAddCatalog(
  [in] HCATADMIN hCatAdmin,
  [in] PWSTR     pwszCatalogFile,
  [in] PWSTR     pwszSelectBaseName,
  [in] DWORD     dwFlags
);

Paramètres

[in] hCatAdmin

Gérer précédemment attribué par la fonction CryptCATAdminAcquireContext .

[in] pwszCatalogFile

Pointeur vers une chaîne terminée par null pour le chemin complet du catalogue à ajouter.

[in] pwszSelectBaseName

Pointeur vers une chaîne terminée par null pour le nom du catalogue lorsqu’il est stocké. Si le paramètre a la valeur NULL, un nom unique est généré pour le catalogue.

[in] dwFlags

Si l’indicateur CRYPTCAT_ADDCATALOG_HARDLINK (0x00000001) est spécifié, le catalogue spécifié dans l’appel sera lié en dur à plutôt qu’copié. La liaison matérielle au lieu de copier un catalogue réduit la quantité d’espace disque requise par Windows.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle du contexte d’informations du catalogue. Si la fonction échoue, la valeur de retour est NULL. Une fois que vous avez terminé d’utiliser le handle retourné, libérez-le en appelant la fonction CryptCATAdminReleaseCatalogContext .

Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError . Pour obtenir la liste complète des codes d’erreur fournis par le système d’exploitation, consultez Codes d’erreur système.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mscat.h
Bibliothèque Wintrust.lib
DLL Wintrust.dll

Voir aussi

CryptCATAdminAcquireContext

CryptCATAdminReleaseCatalogContext