Fonction ImageEnumerateCertificates (imagehlp.h)
Récupère des informations sur les certificats actuellement contenus dans un fichier image.
Syntaxe
BOOL IMAGEAPI ImageEnumerateCertificates(
[in] HANDLE FileHandle,
[in] WORD TypeFilter,
[out] PDWORD CertificateCount,
[in, out] PDWORD Indices,
[in, optional] DWORD IndexCount
);
Paramètres
[in] FileHandle
Handle du fichier image à examiner. Ce handle doit être ouvert pour FILE_READ_DATA accès.
[in] TypeFilter
Type de section de certificat à utiliser comme filtre lors du retour d’informations de certificat. CERT_SECTION_TYPE_ANY doit être transmis pour obtenir des informations sur tous les types de sections présents dans l’image.
[out] CertificateCount
Pointeur vers une variable qui reçoit le nombre de certificats dans l’image contenant des sections du type spécifié par le paramètre TypeFilter . Si aucun n’est trouvé, ce paramètre est égal à zéro.
[in, out] Indices
Fournit éventuellement une mémoire tampon à utiliser pour renvoyer un tableau d’index aux certificats contenant des sections du type spécifié. Aucun classement ne doit être supposé pour les valeurs d’index, et il n’est pas garanti qu’elles soient contiguës quand CERT_SECTION_TYPE_ANY est interrogé.
[in, optional] IndexCount
Taille de la mémoire tampon Indexs , en DWORDs. Ce paramètre est examiné chaque fois que des index sont présents . Si CertificateCount est supérieur à IndexCount, les index sont renseignés avec les premières sections IndexCount trouvées dans l’image ; les autres ne seront pas retournés.
Valeur retournée
Si la fonction réussit, la valeur de retour est TRUE.
Si la fonction échoue, la valeur de retour est FALSE. Pour récupérer des informations d’erreur étendues, appelez GetLastError.
Notes
La fonction ImageEnumerateCertificates retourne des informations sur les certificats actuellement contenus dans un fichier image. Il dispose de fonctionnalités de filtrage qui permettent de retourner des certificats contenant des sections de n’importe quel type (ou de n’importe quel type).
Une fois les index des certificats intéressants découverts, ils peuvent être transmis à la fonction ImageGetCertificateData pour obtenir les corps réels des certificats.
Toutes les fonctions ImageHlp, telles que celle-ci, sont à thread unique. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement un comportement inattendu ou une altération de la mémoire. Pour éviter cela, vous devez synchroniser tous les appels simultanés de plusieurs threads vers cette fonction.
Configuration requise
| 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 | imagehlp.h |
| Bibliothèque | Imagehlp.lib |
| DLL | Imagehlp.dll |