Funzione RtlHashUnicodeString (wdm.h)
La routine RtlHashUnicodeString crea un valore hash da un determinato algoritmo di stringa Unicode e hash.
Sintassi
NTSYSAPI NTSTATUS RtlHashUnicodeString(
[in] PCUNICODE_STRING String,
[in] BOOLEAN CaseInSensitive,
[in] ULONG HashAlgorithm,
[out] PULONG HashValue
);
Parametri
[in] String
Puntatore a una struttura UNICODE_STRING che contiene la stringa Unicode da convertire in un valore hash.
[in] CaseInSensitive
Specifica se trattare la stringa Unicode come distinzione tra maiuscole e minuscole durante il calcolo del valore hash. Se CaseInSensitive è TRUE, un hash stringa minuscolo e maiuscolo allo stesso valore.
[in] HashAlgorithm
Algoritmo hash da utilizzare. Se HashAlgorithm è HASH_STRING_ALGORITHM_X65599, RtlHashUnicodeString usa l'algoritmo di hash x65599. Se HashAlgorithm è HASH_STRING_ALGORITHM_DEFAULT, RtlHashUnicodeString usa l'algoritmo predefinito. Attualmente, l'algoritmo predefinito è l'algoritmo di hash x65599.
[out] HashValue
Puntatore a una variabile ULONG che riceve il valore hash.
Valore restituito
RtlHashUnicodeString restituisce STATUS_SUCCESS in caso di esito positivo o il valore NTSTATUS appropriato in caso di errore. La routine restituisce un valore STATUS_INVALID_PARAMETER se la stringa Unicode è NULL, HashValue è NULL o il chiamante specifica un valore non definito per HashAlgorithm.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows XP e versioni successive di Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |