Fonction RtlHashUnicodeString (wdm.h)

La routine RtlHashUnicodeString crée une valeur de hachage à partir d’une chaîne Unicode et d’un algorithme de hachage donnés.

Syntaxe

NTSYSAPI NTSTATUS RtlHashUnicodeString(
  [in]  PCUNICODE_STRING String,
  [in]  BOOLEAN          CaseInSensitive,
  [in]  ULONG            HashAlgorithm,
  [out] PULONG           HashValue
);

Paramètres

[in] String

Pointeur vers une structure UNICODE_STRING qui contient la chaîne Unicode à convertir en valeur de hachage.

[in] CaseInSensitive

Spécifie s’il faut traiter la chaîne Unicode comme respectant la casse lors du calcul de la valeur de hachage. Si CaseInSensitive a la valeur TRUE, un hachage de chaîne en minuscules et majuscules à la même valeur.

[in] HashAlgorithm

Algorithme de hachage à utiliser. Si HashAlgorithm est HASH_STRING_ALGORITHM_X65599, RtlHashUnicodeString utilise l’algorithme de hachage x65599. Si HashAlgorithm est HASH_STRING_ALGORITHM_DEFAULT, RtlHashUnicodeString utilise l’algorithme par défaut. Actuellement, l’algorithme par défaut est l’algorithme de hachage x65599.

[out] HashValue

Pointeur vers une variable ULONG qui reçoit la valeur de hachage.

Valeur retournée

RtlHashUnicodeString retourne STATUS_SUCCESS en cas de réussite ou la valeur NTSTATUS appropriée en cas d’échec. La routine retourne une valeur STATUS_INVALID_PARAMETER si la chaîne Unicode a la valeur NULL, HashValue a la valeur NULL ou si l’appelant spécifie une valeur non définie pour HashAlgorithm.

Configuration requise

Voir aussi

UNICODE_STRING