CryptCATAdminEnumCatalogFromHash, fonction (mscat.h)

[La fonction CryptCATAdminEnumCatalogFromHash peut être utilisée 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 CryptCATAdminEnumCatalogFromHash énumère les catalogues qui contiennent un hachage spécifié. Le hachage est généralement retourné par la fonction CryptCATAdminCalcHashFromFileHandle . Après l’appel final à cette fonction, appelez CryptCATAdminReleaseCatalogContext pour libérer la mémoire allouée.

Syntaxe

HCATINFO CryptCATAdminEnumCatalogFromHash(
  [in] HCATADMIN hCatAdmin,
  [in] BYTE      *pbHash,
  [in] DWORD     cbHash,
  [in] DWORD     dwFlags,
  [in] HCATINFO  *phPrevCatInfo
);

Paramètres

[in] hCatAdmin

Handle à un contexte d’administrateur de catalogue précédemment attribué par la fonction CryptCATAdminAcquireContext .

[in] pbHash

Pointeur vers la mémoire tampon qui contient le hachage récupéré en appelant CryptCATAdminCalcHashFromFileHandle.

[in] cbHash

Nombre d’octets dans la mémoire tampon allouée pour pbHash.

[in] dwFlags

Ce paramètre est réservé à une utilisation ultérieure et doit être défini sur zéro.

[in] phPrevCatInfo

Pointeur vers le handle vers le contexte de catalogue précédent ou NULL. Pour obtenir le premier catalogue qui contient le hachage, ou pour démarrer une énumération de tous les catalogues, passez null pour ce paramètre. Pour continuer l’énumération, transmettez la valeur de retour de l’appel précédent jusqu’à ce qu’il n’y ait plus de catalogues trouvés.

Valeur retournée

La valeur de retour est un handle pour le contexte de catalogue, ou NULL s’il n’y a plus de catalogues à énumérer.

Note: Le type HCATINFO est simplement un typedef pour HANDLE, ce qui facilite l’utilisation accidentelle de HCATINFO dans un contexte incorrect. En particulier, cela n’est PAS identique à un HANDLE retourné par CryptCATOpen, même si le compilateur ne vous empêche pas d’utiliser HCATINFO dans une fonction qui attend un handle de catalogue. Pour acquérir un handle de catalogue à partir de cette fonction, appelez d’abord CryptCATCatalogInfoFromContext pour obtenir le nom de fichier du catalogue, puis appelez CryptCATOpen avec ce nom de fichier.

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.

Note: La fonction retourne une valeur de type HCATINFO, mais il s’agit simplement d’un typedef pour HANDLE. Pour cette raison, il est facile d’utiliser accidentellement HCATINFO lors de l’appel d’une fonction qui attend un autre type de HANDLE. En particulier, cela n’est pas la même chose qu’un HANDLE retourné par CryptCATOpen, même si le compilateur ne vous empêche pas d’utiliser HCATINFO dans une fonction qui attend un handle de catalogue.

Pour acquérir un handle de catalogue à partir de cette fonction, appelez d’abord CryptCATCatalogInfoFromContext pour obtenir le nom de fichier du catalogue, puis appelez CryptCATOpen avec ce nom de fichier pour ouvrir le catalogue.

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