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

Weitere Informationen

UNICODE_STRING