Función RtlHashUnicodeString (wdm.h)

  • Artículo

La rutina RtlHashUnicodeString crea un valor hash a partir de una cadena Unicode determinada y un algoritmo hash.

Sintaxis

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

Parámetros

[in] String

Puntero a una estructura UNICODE_STRING que contiene la cadena Unicode que se va a convertir en un valor hash.

[in] CaseInSensitive

Especifica si se debe tratar la cadena Unicode como distingue mayúsculas de minúsculas al calcular el valor hash. Si CaseInSensitive es TRUE, un hash de cadena en minúsculas y mayúsculas en el mismo valor.

[in] HashAlgorithm

Algoritmo hash que se va a usar. Si HashAlgorithm es HASH_STRING_ALGORITHM_X65599, RtlHashUnicodeString usa el algoritmo hash x65599. Si HashAlgorithm es HASH_STRING_ALGORITHM_DEFAULT, RtlHashUnicodeString usa el algoritmo predeterminado. Actualmente, el algoritmo predeterminado es el algoritmo hash x65599.

[out] HashValue

Puntero a una variable ULONG que recibe el valor hash.

Valor devuelto

RtlHashUnicodeString devuelve STATUS_SUCCESS si se ejecuta correctamente o el valor NTSTATUS adecuado en caso de error. La rutina devuelve un valor de STATUS_INVALID_PARAMETER si la cadena Unicode es NULL, HashValue es NULL o el autor de la llamada especifica un valor indefinido para HashAlgorithm.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows XP y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Consulte también

UNICODE_STRING