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
| 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 |