ImageEnumerateCertificates-Funktion (imagehlp.h)

  • Artikel

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

Weitere Informationen

ImageGetCertificateData

ImageHlp-Funktionen