Funzione ImageEnumerateCertificates (imagehlp.h)
Recupera informazioni sui certificati attualmente contenuti in un file di immagine.
Sintassi
BOOL IMAGEAPI ImageEnumerateCertificates(
[in] HANDLE FileHandle,
[in] WORD TypeFilter,
[out] PDWORD CertificateCount,
[in, out] PDWORD Indices,
[in, optional] DWORD IndexCount
);
Parametri
[in] FileHandle
Handle per il file di immagine da esaminare. Questo handle deve essere aperto per l'accesso FILE_READ_DATA.
[in] TypeFilter
Tipo di sezione del certificato da usare come filtro durante la restituzione delle informazioni sul certificato. CERT_SECTION_TYPE_ANY deve essere passato per informazioni su tutti i tipi di sezione presenti nell'immagine.
[out] CertificateCount
Puntatore a una variabile che riceve il numero di certificati nell'immagine contenente sezioni del tipo specificato dal parametro TypeFilter . Se non viene trovato alcun elemento, questo parametro è zero.
[in, out] Indices
Facoltativamente, fornisce un buffer da usare per restituire una matrice di indici ai certificati contenenti sezioni del tipo specificato. Nessun ordinamento deve essere assunto per i valori di indice, né è garantito che siano contigui quando CERT_SECTION_TYPE_ANY viene eseguita una query.
[in, optional] IndexCount
Dimensioni del buffer indici , in DWORD. Questo parametro verrà esaminato ogni volta che sono presenti indici . Se CertificateCount è maggiore di IndexCount, gli indici verranno compilati con le prime sezioni IndexCount trovate nell'immagine; tutti gli altri non verranno restituiti.
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 funzione ImageEnumerateCertificates restituisce informazioni sui certificati attualmente contenuti in un file di immagine. Include funzionalità di filtro che consentono ai certificati contenenti sezioni di qualsiasi tipo singolo (o di qualsiasi tipo) di essere restituite.
Dopo aver individuato gli indici di certificati interessanti, possono essere passati alla funzione ImageGetCertificateData per ottenere i corpi effettivi dei certificati.
Tutte le funzioni ImageHlp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione potrebbero causare 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
| 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 |