ImageGetCertificateData, fonction (imagehlp.h)

Récupère un certificat complet à partir d’un fichier.

Syntaxe

BOOL IMAGEAPI ImageGetCertificateData(
  [in]      HANDLE            FileHandle,
  [in]      DWORD             CertificateIndex,
  [out]     LPWIN_CERTIFICATE Certificate,
  [in, out] PDWORD            RequiredLength
);

Paramètres

[in] FileHandle

Handle du fichier image. Ce handle doit être ouvert pour un accès FILE_READ_DATA .

[in] CertificateIndex

Index du certificat à retourner.

[out] Certificate

Pointeur vers une structure WIN_CERTIFICATE qui reçoit les données de certificat. Si la mémoire tampon n’est pas assez grande pour contenir la structure, la fonction échoue et le dernier code d’erreur est défini sur ERROR_INSUFFICIENT_BUFFER.

[in, out] RequiredLength

Lors de l’entrée, ce paramètre spécifie la longueur de la mémoire tampon de certificat en octets. En cas de réussite, il reçoit la longueur du certificat.

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.

Remarques

La structure WIN_CERTIFICATE est définie comme suit :

typedef struct _WIN_CERTIFICATE {
    DWORD       dwLength;
    WORD        wRevision;
    WORD        wCertificateType;   // WIN_CERT_TYPE_xxx
    BYTE        bCertificate[ANYSIZE_ARRAY];
} WIN_CERTIFICATE, *LPWIN_CERTIFICATE;

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

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	imagehlp.h
Bibliothèque	Imagehlp.lib
DLL	Imagehlp.dll

Voir aussi

Fonctions ImageHlp