ImageGetCertificateData-Funktion (imagehlp.h)
Ruft ein vollständiges Zertifikat aus einer Datei ab.
Syntax
BOOL IMAGEAPI ImageGetCertificateData(
[in] HANDLE FileHandle,
[in] DWORD CertificateIndex,
[out] LPWIN_CERTIFICATE Certificate,
[in, out] PDWORD RequiredLength
);
Parameter
[in] FileHandle
Ein Handle für die Bilddatei. Dieses Handle muss für FILE_READ_DATA Zugriff geöffnet werden.
[in] CertificateIndex
Der Index des zurückzugebenden Zertifikats.
[out] Certificate
Ein Zeiger auf eine WIN_CERTIFICATE Struktur, die die Zertifikatdaten empfängt. Wenn der Puffer nicht groß genug ist, um die Struktur zu enthalten, schlägt die Funktion fehl, und der letzte Fehlercode wird auf ERROR_INSUFFICIENT_BUFFER festgelegt.
[in, out] RequiredLength
Bei der Eingabe gibt dieser Parameter die Länge des Zertifikatpuffers in Bytes an. Bei Erfolg erhält er die Länge des Zertifikats.
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 WIN_CERTIFICATE-Struktur ist wie folgt definiert:
typedef struct _WIN_CERTIFICATE {
DWORD dwLength;
WORD wRevision;
WORD wCertificateType; // WIN_CERT_TYPE_xxx
BYTE bCertificate[ANYSIZE_ARRAY];
} WIN_CERTIFICATE, *LPWIN_CERTIFICATE;
Alle ImageHlp-Funktionen, z. B. diese, sind Singlethreads. 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
| Anforderung | Wert |
|---|---|
| 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 |