Fonction RtlHashUnicodeString (wdm.h)

  • Article

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

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows XP et les versions ultérieures de Windows.
Plateforme cible Universal
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Voir aussi

UNICODE_STRING