Função RtlHashUnicodeString (wdm.h)

  • Artigo

A rotina RtlHashUnicodeString cria um valor de hash de uma determinada cadeia de caracteres Unicode e um algoritmo de hash.

Sintaxe

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

Parâmetros

[in] String

Um ponteiro para uma estrutura UNICODE_STRING que contém a cadeia de caracteres Unicode a ser convertida em um valor de hash.

[in] CaseInSensitive

Especifica se a cadeia de caracteres Unicode diferencia maiúsculas de minúsculas ao calcular o valor de hash. Se CaseInSensitive for TRUE, um hash de cadeia de caracteres em letras minúsculas e maiúsculas para o mesmo valor.

[in] HashAlgorithm

O algoritmo de hash a ser usado. Se HashAlgorithm for HASH_STRING_ALGORITHM_X65599, RtlHashUnicodeString usará o algoritmo de hash x65599. Se HashAlgorithm for HASH_STRING_ALGORITHM_DEFAULT, RtlHashUnicodeString usará o algoritmo padrão. Atualmente, o algoritmo padrão é o algoritmo de hash x65599.

[out] HashValue

Um ponteiro para uma variável ULONG que recebe o valor de hash.

Retornar valor

RtlHashUnicodeString retorna STATUS_SUCCESS com êxito ou o valor NTSTATUS apropriado em caso de falha. A rotina retornará um valor STATUS_INVALID_PARAMETER se a cadeia de caracteres Unicode for NULL, HashValue for NULL ou o chamador especificar um valor indefinido para HashAlgorithm.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows XP e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Confira também

UNICODE_STRING