ImageEnumerateCertificates-Funktion (imagehlp.h)
Ruft Informationen zu den Zertifikaten ab, die derzeit in einer Imagedatei enthalten sind.
Syntax
BOOL IMAGEAPI ImageEnumerateCertificates(
[in] HANDLE FileHandle,
[in] WORD TypeFilter,
[out] PDWORD CertificateCount,
[in, out] PDWORD Indices,
[in, optional] DWORD IndexCount
);
Parameter
[in] FileHandle
Ein Handle für die zu untersuchende Bilddatei. Dieses Handle muss für FILE_READ_DATA Zugriff geöffnet werden.
[in] TypeFilter
Der Zertifikatabschnittstyp, der beim Zurückgeben von Zertifikatinformationen als Filter verwendet werden soll. CERT_SECTION_TYPE_ANY sollten für Informationen zu allen Abschnittstypen übergeben werden, die im Bild vorhanden sind.
[out] CertificateCount
Ein Zeiger auf eine Variable, die die Anzahl von Zertifikaten in der Abbildung empfängt, die Abschnitte des typs enthält, die durch den TypeFilter-Parameter angegeben sind. Wenn keine gefunden wird, ist dieser Parameter 0.
[in, out] Indices
Stellt optional einen Puffer bereit, mit dem ein Array von Indizes an die Zertifikate zurückgegeben werden kann, die Abschnitte des angegebenen Typs enthalten. Es sollte keine Reihenfolge für die Indexwerte angenommen werden, noch ist garantiert, dass sie zusammenhängend sind, wenn CERT_SECTION_TYPE_ANY abgefragt wird.
[in, optional] IndexCount
Die Größe des Indizespuffers in DWORDs. Dieser Parameter wird überprüft, wenn Indizes vorhanden sind. Wenn CertificateCount größer als IndexCount ist, werden Indizes mit den ersten IndexCount-Abschnitten in der Abbildung ausgefüllt. alle anderen werden nicht zurückgegeben.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.
Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.
Hinweise
Die ImageEnumerateCertificates-Funktion gibt Informationen zu den Zertifikaten zurück, die derzeit in einer Imagedatei enthalten sind. Es verfügt über Filterfunktionen, mit denen Zertifikate zurückgegeben werden können, die Abschnitte eines beliebigen Typs (oder eines beliebigen Typs) enthalten.
Nachdem die Indizes interessanter Zertifikate ermittelt wurden, können sie an die ImageGetCertificateData-Funktion übergeben werden, um die tatsächlichen Textkörper der Zertifikate abzurufen.
Alle ImageHlp-Funktionen, z. B. diese, sind single threaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imagehlp.h |
| Bibliothek | Imagehlp.lib |
| DLL | Imagehlp.dll |