HashCheckString (Function)

AYUDA EN LÍNEA
WINDEV, WEBDEV Y WINDEV MOBILE

Versión:

Inicio | Iniciar sesión | Español

Este contenido se ha traducido automáticamente. Haga clic aquí para ver la versión en inglés.

Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones Hash

Availability of algorithms
HashCheckString and UNICODE

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

HashCheckString (Function)

Checks the Hash of a character string for a specific type of algorithm. You have the ability to check:

a simple hash.
a hash with message authentication.
a hash obtained with a key derivation function that takes a salt as parameter (PBKDF2).
Not available.

Reminder Hashing is used to produce a condensed summary of a file or character string. This summary is called Hash.

Ejemplo

// Check password: 
// - Password typed in the "EDT_TypePassword" control
// - The password Hash is found in the "User.HashPassword" item
IF HashCheckString(HA_MD5_128, EDT_TypePassword, ...
		User.HashPassword) = True THEN
	Info("Password OK.")
	// Rest of process
	// ...
ELSE
	Error("Wrong password.")
	// Resume the input
	SetFocusAndReturnToUserInput(EDT_TypePassword)
END

sHash is string = "9F 04 F4 1A 84 85 14 16 20 50 E3 D6"
HashCheckString(HA_SHA_160, "abc", HexaToBuffer(sHash), HashCheckString_Callback)

INTERNAL PROCEDURE HashCheckString_Callback(bRes boolean)
	IF bRes = False THEN Trace("Error during verification")
END

Sintaxis

Checking a simple hash Ocultar los detalles

<Result> = HashCheckString(<Type of algorithm> , <String> , <Hash>)

<Result>: Boolean

True if the result when <String> was hashed by <Type of algorithm> corresponds to <Hash>,
False otherwise.

<Type of algorithm>: Integer constant

Indicates the type of algorithm used when hashing the <String>:
DJB2 family (Bernstein)
HA_DJB2_32
HA_DJB2_64
The constants of this family are not available.
MD4 family HA_MD4
MD5 family HA_MD5_128
Please note: this type of algorithm is currently deprecated.
MURMUR family
HA_MURMUR_1 Murmur algorithm version 1: 32-bit hash result
HA_MURMUR_2 Murmur algorithm version 2: 32-bit hash result
HA_MURMUR_2_64A Murmur algorithm version 2: 64-bit hash result optimized for 64-bit processors
HA_MURMUR_2_64B Murmur algorithm version 2: 64-bit hash result optimized for 32-bit processors
HA_MURMUR_2_A Murmur version 2 incremental algorithm: 32-bit hash result
HA_MURMUR_2_BIG_ENDIAN Murmur algorithm version 2 for big-endian machine: 32-bit hash result
HA_MURMUR_2_ALIGNE Murmur algorithm version 2 for aligned machine: 32-bit hash result
HA_MURMUR_3_32 Murmur algorithm version 3: 32-bit hash result
HA_MURMUR_3_128_X86 Murmur algorithm version 3: 128-bit hash result optimized for 32-bit processors
HA_MURMUR_3_128_X64 Murmur algorithm version 3: 128-bit hash result optimized for 64-bit processors
The constants of this family are not available.
RIPEMD family
HA_RIPEMD_128
HA_RIPEMD_160
The constants of this family are not available.
SHA family
HA_SHA_160 (also called SHA-1)
HA_SHA_256 (FIPS PUB 198 specifications)
HA_SHA_256_DOUBLE
HA_SHA_384
HA_SHA_512
SHA-3 family
HA_SHA3_224
HA_SHA3_256
HA_SHA3_384
HA_SHA3_512
TIGER family
HA_TIGER_128
HA_TIGER_160
HA_TIGER_192
The constants of this family are not available.
WHIRLPOOL family HA_WHIRLPOOL
Not available.
CKSUM family
HA_CKSUM_8
HA_CKSUM_16
HA_CKSUM_32
HA_CKSUM_64
The constants of this family are not available.
MD4 / MD5 / SHA / RIPEMD algorithms: classic cryptographic hash functions.
TIGER / WHIRLPOOL algorithms: hash functions with very good cryptographic properties, optimized for 64-bit (but can be used in 32-bit).
CKSUM algorithms: hash functions with no cryptographic properties, to be used only for minimal checks or hash tables.
DJB2 algorithm (Bernstein): string-only hash functions with no cryptographic properties, to be used only for minimal checks or hash tables. Few risks to get an identical hash.
MURMUR algorithm: very fast hash functions with no cryptographic properties. This algorithm is used by the "bloom filter" of bitcoin wallets.

<String>: Character string

String for which the Hash will be checked.

<Hash>: Character string

Hash of string to check. This Hash must be the result of HashString previously called for <String> using the <Type of algorithm>.

Checking a simple hash Ocultar los detalles

HashCheckString(<Type of algorithm> , <String> , <Hash> , <WLanguage procedure>)

<Type of algorithm>: Integer constant

Indicates the type of algorithm used when hashing the <String>:
SHA family
HA_SHA_160 (also called SHA-1)
HA_SHA_256 (FIPS PUB 198 specifications)
HA_SHA_256_DOUBLE
HA_SHA_384
HA_SHA_512

Remarks:
These hash algorithms are not allowed in Internet Explorer.
The HA_SHA_160 algorithm is not allowed in Edge.

<String>: Character string

String for which the Hash will be checked.

<Hash>: Character string

Hash of string to check. This Hash must be the result of HashString previously called for <String> using the <Type of algorithm>.

<WLanguage procedure>: Procedure name

Name of the WLanguage procedure ("callback") called when hashing. This procedure is used to get the hash result. For more details, see Procedure used by HashCheckString.

Checking a hash with message authentication (HMAC/MURMUR algorithm) Ocultar los detalles

<Result> = HashCheckString(<Type of algorithm> , <String> , <Hash> , <Secret key>)

<Result>: Boolean

True if the result when <String> was hashed by <Type of algorithm> corresponds to <Hash>,
False otherwise.

<Type of algorithm>: Integer constant

Indicates the type of algorithm (HMAC or MURMUR) used to hash the <String>:
MD4 family HA_HMAC_MD4

MD5 family HA_HMAC_MD5_128
Please note: this type of algorithm is currently deprecated.
MURMUR family
HA_MURMUR_1 Murmur algorithm version 1: 32-bit hash result
HA_MURMUR_2 Murmur algorithm version 2: 32-bit hash result
HA_MURMUR_2_64A Murmur algorithm version 2: 64-bit hash result optimized for 64-bit processors
HA_MURMUR_2_64B Murmur algorithm version 2: 64-bit hash result optimized for 32-bit processors
HA_MURMUR_2_A Murmur version 2 incremental algorithm: 32-bit hash result
HA_MURMUR_2_BIG_ENDIAN Murmur algorithm version 2 for big-endian machine: 32-bit hash result
HA_MURMUR_2_ALIGNE Murmur algorithm version 2 for aligned machine: 32-bit hash result
HA_MURMUR_3_32 Murmur algorithm version 3: 32-bit hash result
HA_MURMUR_3_128_X86 Murmur algorithm version 3: 128-bit hash result optimized for 32-bit processors
HA_MURMUR_3_128_X64 Murmur algorithm version 3: 128-bit hash result optimized for 64-bit processors
The constants of this family are not available.
RIPEMD family
HA_HMAC_RIPEMD_128
HA_HMAC_RIPEMD_160
The constants of this family are not available.
SHA family
HA_HMAC_SHA_160
HA_HMAC_SHA_256
HA_HMAC_SHA_256_DOUBLE
HA_HMAC_SHA_384
HA_HMAC_SHA_512
SHA-3 family
HA_HMAC_SHA3_224
HA_HMAC_SHA3_256
HA_HMAC_SHA3_384
HA_HMAC_SHA3_512
TIGER family
HA_HMAC_TIGER_128
HA_HMAC_TIGER_160
HA_HMAC_TIGER_192
The constants of this family are not available.
WHIRLPOOL family HA_HMAC_WHIRLPOOL
Not available.
MD4 / MD5 / SHA / RIPEMD algorithms: classic cryptographic hash functions.
TIGER / WHIRLPOOL algorithms: hash functions with very good cryptographic properties, optimized for 64-bit (but can be used in 32-bit).
MURMUR algorithm: very fast hash functions with no cryptographic properties. This algorithm is used by the "bloom filter" of bitcoin wallets.

<String>: Character string

String for which the Hash will be checked.

<Hash>: Character string

Hash of string to check. This Hash must be the result of HashString previously called for <String> using the <Type of algorithm>.

<Secret key>: Character string or Secret string

Authentication key of message. This key must be identical to the one used to calculate the Hash.
Novedad versión 2025
Cadenas secretas: Si utiliza el almacén de cadenas secretas, el tipo de cadena secreta utilizado para este parámetro puede ser:
Buffer - ASCII o Buffer - UTF-8,
ANSI string - Latin,
ANSI o Unicode string,
Unicode string.
Para obtener más información sobre las cadenas secretas y el almacén, consulte Almacén de cadenas secretas.
Novedad versión 2025
Las cadenas secretas no están disponibles para este parámetro en aplicaciones Android y widgets de Android.
This parameter must not be an empty string.

Checking a hash with message authentication (HMAC algorithm) Ocultar los detalles

HashCheckString(<Type of algorithm> , <String> , <Hash> , <Secret key> , <WLanguage procedure>)

<Type of algorithm>: Integer constant

Indicates the type of algorithm (HMAC) used to hash the <String> string:
SHA family
HA_HMAC_SHA_160
HA_HMAC_SHA_256
HA_HMAC_SHA_384
HA_HMAC_SHA_512

Remarks:
These hash algorithms are not allowed in Internet Explorer.
These hash algorithms are not allowed in Edge.

<String>: Character string

String for which the Hash will be checked.

<Hash>: Character string

Hash of string to check. This Hash must be the result of HashString previously called for <String> using the <Type of algorithm>.

<Secret key>: Character string or Secret string

Authentication key of message. This key must be identical to the one used to calculate the Hash.
Novedad versión 2025
Cadenas secretas: Si utiliza el almacén de cadenas secretas, el tipo de cadena secreta utilizado para este parámetro puede ser:
Buffer - ASCII o Buffer - UTF-8,
ANSI string - Latin,
ANSI o Unicode string,
Unicode string.
Para obtener más información sobre las cadenas secretas y el almacén, consulte Almacén de cadenas secretas.
Novedad versión 2025
Las cadenas secretas no están disponibles para este parámetro en aplicaciones Android y widgets de Android.

<WLanguage procedure>: Procedure name

Name of the WLanguage procedure ("callback") called when hashing. This procedure is used to get the hash result. For more details, see Procedure used by HashCheckString.

Checking a hash obtained using a key derivation function that takes a salt as parameter (PBKDF2) Ocultar los detalles

HashCheckString(<Type of algorithm> , <String> , <Hash> , <Salt> , <Iteration> , <Length>)

<Type of algorithm>: Integer constant

Specifies the type of pseudo-random algorithm used by PBKDF2 to hash <String>:
MD4 family HA_PBKDF2_HMAC_MD4
MD5 family HA_PBKDF2_HMAC_MD5_128
Please note: this type of algorithm is currently deprecated.
RIPEMD family
HA_PBKDF2_HMAC_RIPEMD_128
HA_PBKDF2_HMAC_RIPEMD_160
SHA family
HA_PBKDF2_HMAC_SHA_160
HA_PBKDF2_HMAC_SHA_256
HA_PBKDF2_HMAC_SHA_256_DOUBLE
HA_PBKDF2_HMAC_SHA_384
HA_PBKDF2_HMAC_SHA_512
SHA-3 family
HA_PBKDF2_HMAC_SHA3_224
HA_PBKDF2_HMAC_SHA3_256
HA_PBKDF2_HMAC_SHA3_384
HA_PBKDF2_HMAC_SHA3_512
TIGER family
HA_PBKDF2_HMAC_TIGER_128
HA_PBKDF2_HMAC_TIGER_160
HA_PBKDF2_HMAC_TIGER_192
WHIRLPOOL family HA_PBKDF2_HMAC_WHIRLPOOL
MD4 / MD5 / SHA / RIPEMD algorithms: classic cryptographic hash functions.
TIGER / WHIRLPOOL algorithms: hash functions with very good cryptographic properties, optimized for 64-bit (but can be used in 32-bit).

<String>: Character string

String for which the Hash will be checked.

<Hash>: Character string

Hash of string to check. This Hash must be the result of HashString previously called for <String> using the <Type of algorithm>.

<Salt>: Character string

Cryptographic salt identical to the one used to calculate the Hash.

<Iteration>: Integer

Number of iterations of the algorithm. This parameter must be identical to the one used to calculate the Hash.

<Length>: Integer

Length of the derived key. This parameter must be identical to the one used to calculate the Hash.

Observaciones

Availability of algorithms

Algorithms are available depending on the PHP server configuration ('mhash' extension, PHP 5 with native hash function, etc).

Only the following algorithms are supported:

HA_HMAC_MD5_128
HA_HMAC_SHA_160, HA_HMAC_SHA_256, HA_HMAC_SHA_384, HA_SHA_HMAC_512
HA_HMAC_SHA_256_DOUBLE
HA_MD4
HA_MD5_128
HA_SHA_160, HA_SHA_256, HA_SHA_384, HA_SHA_512
HA_SHA_256_DOUBLE

HashCheckString and UNICODE

Cross-platform development To use string hashes across platforms (e.g. a hash generated on iOS and verified on Android or Windows), do not use Unicode strings. Indeed, the Unicode strings do not have the same format according to the platforms. In this case, we advise you to use strings in ANSI or UTF 8 format (and to convert the Unicode strings if necessary).

Clasificación Lógica de negocio / UI: Lógica de negocio

Componente: wd300com.dll

Ver también

Versión mínima requerida

Versión 11

Esta página también está disponible para…

Comentarios

Haga clic en [Agregar] para publicar un comentario

Última modificación: 16/05/2025

Señalar un error o enviar una sugerencia | Ayuda local