ImageAddCertificate-Funktion (imagehlp.h)

Fügt der angegebenen Datei ein Zertifikat hinzu.

Syntax

BOOL IMAGEAPI ImageAddCertificate(
  [in]  HANDLE            FileHandle,
  [in]  LPWIN_CERTIFICATE Certificate,
  [out] PDWORD            Index
);

Parameter

[in] FileHandle

Ein Handle für die zu ändernde Bilddatei. Dieses Handle muss für FILE_READ_DATA- und FILE_WRITE_DATA-Zugriff geöffnet werden.

[in] Certificate

Ein Zeiger auf einen WIN_CERTIFICATE-Header und alle zugehörigen Abschnitte. Der Length-Member im Zertifikatheader wird verwendet, um die Länge dieses Puffers zu bestimmen.

[out] Index

Ein Zeiger auf eine Variable, die den Index des neu hinzugefügten Zertifikats empfängt.

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

Das Zertifikat wird am Ende der vorhandenen Liste von Zertifikaten hinzugefügt und einem Index zugewiesen.

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

ImageRemoveCertificate