RtlHashUnicodeString-Funktion (wdm.h)

Die RtlHashUnicodeString-Routine erstellt einen Hashwert aus einer bestimmten Unicode-Zeichenfolge und einem Hashalgorithmus.

Syntax

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

Parameter

[in] String

Ein Zeiger auf eine UNICODE_STRING-Struktur , die die Unicode-Zeichenfolge enthält, die in einen Hashwert konvertiert werden soll.

[in] CaseInSensitive

Gibt an, ob die Unicode-Zeichenfolge beim Berechnen des Hashwerts die Groß-/Kleinschreibung beachten soll. Wenn CaseInSensitiveTRUE ist, wird ein Klein- und Großbuchstaben-Zeichenfolgenhash auf denselben Wert festgelegt.

[in] HashAlgorithm

Der zu verwendende Hashalgorithmus. Wenn HashAlgorithm HASH_STRING_ALGORITHM_X65599 ist, verwendet RtlHashUnicodeString den x65599-Hashingalgorithmus. Wenn HashAlgorithm HASH_STRING_ALGORITHM_DEFAULT ist, verwendet RtlHashUnicodeString den Standardalgorithmus. Derzeit ist der Standardalgorithmus der x65599-Hashingalgorithmus.

[out] HashValue

Ein Zeiger auf eine ULONG-Variable, die den Hashwert empfängt.

Rückgabewert

RtlHashUnicodeString gibt bei Erfolg STATUS_SUCCESS oder den entsprechenden NTSTATUS-Wert bei Fehler zurück. Die Routine gibt einen STATUS_INVALID_PARAMETER Wert zurück, wenn die Unicode-Zeichenfolge NULL, HashValueNULL ist oder der Aufrufer einen nicht definierten Wert für HashAlgorithm angibt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows XP und höheren Versionen von Windows.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Weitere Informationen

UNICODE_STRING