Функция RtlHashUnicodeString (wdm.h)

Статья
02/29/2024

Подпрограмма RtlHashUnicodeString создает хэш-значение из заданной строки Юникода и хэш-алгоритма.

Синтаксис

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

Параметры

[in] String

Указатель на структуру UNICODE_STRING , содержащую строку Юникода для преобразования в хэш-значение.

[in] CaseInSensitive

Указывает, следует ли обрабатывать строку Юникода как учет регистра при вычислении хэш-значения. Если аргумент CaseInSensitive имеет значениеTRUE, строка в нижнем и верхнем регистре хэшируется на одно и то же значение.

[in] HashAlgorithm

Используемый хэш-алгоритм. Если hashAlgorithm HASH_STRING_ALGORITHM_X65599, RtlHashUnicodeString использует алгоритм хэширования x65599. Если hashAlgorithm имеет значение HASH_STRING_ALGORITHM_DEFAULT, RtlHashUnicodeString использует алгоритм по умолчанию. В настоящее время по умолчанию используется алгоритм хэширования x65599.

[out] HashValue

Указатель на переменную ULONG, получающую хэш-значение.

Возвращаемое значение

RtlHashUnicodeString возвращает STATUS_SUCCESS при успешном выполнении или соответствующее значение NTSTATUS при сбое. Подпрограмма возвращает значение STATUS_INVALID_PARAMETER, если строка Юникода имеет значение NULL, HashValue равно NULL или вызывающий объект задает неопределенное значение для HashAlgorithm.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows XP и более поздних версиях Windows.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

См. также раздел

UNICODE_STRING

Поделиться через