Freigeben über

ImageGetCertificateData-Funktion (imagehlp.h)

  • Artikel

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

Weitere Informationen

ImageHlp-Funktionen