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

Vedi anche

ImageGetCertificateData

Funzioni ImageHlp