StringFingerprint()

Syntax

Ergebnis$ = StringFingerprint(String$, Plugin [, Bits [, Format [, HmacKey$ [, HmacKeyFormat]]]])
Beschreibung
Gibt einen Fingerprint ("Fingerabdruck", Prüfsumme) für den angegeben String zurück.

Parameter

String$ Der zu "hashende" String.
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.
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.
Format (optional) Das zu verwendende Stringformat, bevor dieser "gehasht" wird. Dies kann einer der folgenden Werte sein: 
  #PB_UTF8    : der String wird im UTF8 Format gehasht (Standard).
  #PB_Ascii   : der String wird im ASCII Format gehasht.
  #PB_Unicode : der String wird im Unicode (UTF16) Format gehasht.
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 als einen hexadezimalen String zurück.

Beispiel

  UseMD5Fingerprint()

  Debug StringFingerprint("yourpassword", #PB_Cipher_MD5)

Beispiel: HMAC

  UseSHA2Fingerprint()

  ; Verwendet hmacSha256 mit Schlüssel und Nachricht im ASCII-Format
  ; Sollte 4643978965ffcec6e6d73b36a39ae43ceb15f7ef8131b8307862ebc560e7f988 lauten
  Debug StringFingerprint("the message to hash here", #PB_Cipher_SHA2|#PB_Cipher_HMAC, 256, #PB_Ascii, "the shared secret key here", #PB_Ascii)

Siehe auch

FileFingerprint(), StartFingerprint(), Fingerprint()

Unterstützte OS

Alle

<- StartFingerprint() - Cipher Inhaltsverzeichnis - UseCRC32Fingerprint() ->