FileFingerprint()

Syntax

Ergebnis$ = FileFingerprint(Dateiname$, Plugin [, Bits [, Offset [, Länge [, HmacKey$ [, HmacKeyFormat]]]]])

Gibt einen Fingerprint ("Fingerabdruck" oder Prüfsumme) für die angegebene Datei zurück.

Parameter

Dateiname$	Die Datei, von welcher die Prüfsumme (Fingerprint) berechnet werden soll.
Plugin	Das zu verwendende Plugin. Dies kann einer der folgenden Werte sein: #PB_Cipher_CRC32: verwendet den CRC32 Algorithmus. UseCRC32Fingerprint() muss vorher aufgerufen werden, um dieses Plugin zu registrieren. #PB_Cipher_MD5 : verwendet den MD5 Algorithmus. UseMD5Fingerprint() muss vorher aufgerufen werden, um dieses Plugin zu registrieren. #PB_Cipher_SHA1 : verwendet den SHA1 Algorithmus. UseSHA1Fingerprint() muss vorher aufgerufen werden, um dieses Plugin zu registrieren. #PB_Cipher_SHA2 : verwendet den SHA2 Algorithmus. UseSHA2Fingerprint() muss vorher aufgerufen werden, um dieses Plugin zu registrieren. #PB_Cipher_SHA3 : verwendet den SHA3 Algorithmus. UseSHA3Fingerprint() muss vorher aufgerufen werden, um dieses Plugin zu registrieren. Das zu verwendende Plugin kann mit dem #PB_Cipher_HMAC Flag kombiniert werden, um einen HMAC (Hash-basierter Nachrichtenauthentifizierungscode, englisch "hash based message authentication code") anstelle eines regulären 'Fingerprints' zu berechnen. In diesem Fall wird zusätzlich der Parameter "HmacKey$" benötigt. Ein Beispiel für die Verwendung des HMAC-Flags finden Sie unter StringFingerprint().
Bits (optional)	Die für die Prüfsumme zu verwendende Anzahl Bits. Dies wird nur bei den folgenden Plugins unterstützt: #PB_Cipher_SHA2 : kann 224, 256 (Standard), 384 oder 512 lauten. #PB_Cipher_SHA3 : kann 224, 256 (Standard), 384 oder 512 lauten.
Offset (optional)	Der Offset (in Bytes) ausgehend vom Beginn der Datei, an dem mit der Prüfsummen-Berechnung begonnen werden soll.
Länge (optional)	Die Länge (in Bytes), welche für die Prüfsummen-Berechnung verwendet werden soll.
HmacKey$ (optional)	Der geheime Schlüssel, der bei der HMAC-Berechnung verwendet werden soll. Dieser Parameter wird nur verwendet, wenn #PB_Cipher_HMAC beim 'Plugin'-Parameter hinzugefügt wird.
HmacKeyFormat (optional)	Das für den HMAC-Schlüssel zu verwendende Stringformat. Dies kann einer der folgenden Werte sein: #PB_Ascii : kodiert den Schlüssel in ASCII #PB_UTF8 : kodiert den Schlüssel in UTF-8 (Standard). #PB_Unicode: kodiert den Schlüssel in Unicode

Rückgabewert

Gibt den Fingerprint (Prüfsumme, "Fingerabdruck" oder "Hash-Code") zurück, wenn die Berechnung erfolgreich war. Wenn die Datei nicht gefunden wurde oder ein Fehler auftrat, wird das Ergebnis ein leerer String sein.

Siehe auch

Fingerprint(), StartFingerprint(), StringFingerprint()

Unterstützte OS

Alle