ImageGetDigestStream-Funktion (imagehlp.h)

  • Artikel

Ruft die angeforderten Daten aus der angegebenen Bilddatei ab.

Syntax

BOOL IMAGEAPI ImageGetDigestStream(
  [in] HANDLE          FileHandle,
  [in] DWORD           DigestLevel,
  [in] DIGEST_FUNCTION DigestFunction,
  [in] DIGEST_HANDLE   DigestHandle
);

Parameter

[in] FileHandle

Ein Handle für die Bilddatei. Dieses Handle muss für FILE_READ_DATA Zugriff geöffnet werden.

[in] DigestLevel

Die Aspekte des Bilds, die in den zurückgegebenen Datenstrom eingeschlossen werden sollen. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert Bedeutung
CERT_PE_IMAGE_DIGEST_ALL_IMPORT_INFO
0x04
 Schließen Sie alle Importinformationen ein.
CERT_PE_IMAGE_DIGEST_DEBUG_INFO
0x01
 Schließen Sie symbolische Debuginformationen ein.
CERT_PE_IMAGE_DIGEST_RESOURCES
0x02
 Schließen Sie Ressourceninformationen ein.

[in] DigestFunction

Ein Zeiger auf eine Rückrufroutine zum Verarbeiten der Daten. Weitere Informationen finden Sie unter DigestFunction.

[in] DigestHandle

Ein vom Benutzer bereitgestelltes Handle für den Digest. Dieser Parameter wird als erstes Argument an DigestFunction übergeben.

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 ImageGetDigestStream-Funktion gibt die Daten zurück, die aus einer angegebenen Bilddatei verdaut werden sollen, vorbehaltlich des übergebenen DigestLevel-Parameters . Die Reihenfolge der Bytes ist für verschiedene Aufrufe konsistent, was erforderlich ist, um sicherzustellen, dass immer derselbe Nachrichtendigest aus dem abgerufenen Bytedatenstrom erzeugt wird.

Um die plattformübergreifende Kompatibilität sicherzustellen, müssen sich alle Implementierungen dieser Funktion in Bezug auf die Reihenfolge, in der die verschiedenen Teile der Imagedatei zurückgegeben werden, konsistent verhalten.

Die Daten sollten in der folgenden Reihenfolge zurückgegeben werden:

  1. Bildinformationen (ausführbare und statische Daten).
  2. Ressourcendaten.
  3. Debuginformationen.
Wenn eines davon nicht angegeben ist, müssen die restlichen Teile in derselben Reihenfolge zurückgegeben werden.

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