Funzione ImageGetCertificateData (imagehlp.h)

Articolo
02/29/2024

Recupera un certificato completo da un file.

Sintassi

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

Parametri

[in] FileHandle

Handle per il file di immagine. Questo handle deve essere aperto per l'accesso FILE_READ_DATA .

[in] CertificateIndex

Indice del certificato da restituire.

[out] Certificate

Puntatore a una struttura WIN_CERTIFICATE che riceve i dati del certificato. Se il buffer non è sufficientemente grande da contenere la struttura, la funzione ha esito negativo e l'ultimo codice di errore è impostato su ERROR_INSUFFICIENT_BUFFER.

[in, out] RequiredLength

In input, questo parametro specifica la lunghezza del buffer del certificato in byte. In caso di esito positivo, riceve la lunghezza del certificato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

La struttura WIN_CERTIFICATE è definita come segue:

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

Tutte le funzioni ImageHlp, ad esempio questa, sono a thread singolo. Di conseguenza, le chiamate da più thread a questa funzione genereranno un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imagehlp.h
Libreria	Imagehlp.lib
DLL	Imagehlp.dll

Vedi anche

Funzioni ImageHlp

Condividi tramite