ImageGetDigestStream-Funktion (imagehlp.h)

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.

[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.

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

Weitere Informationen

ImageHlp-Funktionen