RtlFindUnicodePrefix-Funktion (ntifs.h)
Die RtlFindUnicodePrefix Routine sucht nach der besten Übereinstimmung für einen bestimmten Unicode-Dateinamen in einer Präfixtabelle.
Syntax
NTSYSAPI PUNICODE_PREFIX_TABLE_ENTRY RtlFindUnicodePrefix(
[in] PUNICODE_PREFIX_TABLE PrefixTable,
[in] PCUNICODE_STRING FullName,
[in] ULONG CaseInsensitiveIndex
);
Parameter
[in] PrefixTable
Zeigen Sie auf die Präfixtabelle. Die Tabelle muss durch Aufrufen von RtlInitializeUnicodePrefixinitialisiert worden sein.
[in] FullName
Zeigen Sie auf eine Unicode-Zeichenfolge, die den vollständigen Pfadnamen für eine Datei enthält.
[in] CaseInsensitiveIndex
Position in den Dateinamen- und Präfixzeichenfolgen, bei denen der Vergleich die Groß-/Kleinschreibung nicht beachtet. Bei dem Zeichenfolgenvergleich wird die Groß-/Kleinschreibung für den ersten CaseInsensitiveIndex Zeichen in jeder Zeichenfolge beachtet, wobei die Groß-/Kleinschreibung für den Rest der Zeichenfolge nicht beachtet wird.
| Wert | Bedeutung |
|---|---|
| 0 | Bei Zeichenfolgenvergleich wird die Groß-/Kleinschreibung nicht beachtet. |
| 1..FullName.Length-1 | Bei Zeichenfolgenvergleich wird bei Zeichen an Positionen 0 bis CaseInsensitiveIndex-1 groß-und kleinschreibung unterschieden, bei Zeichen von Position CaseInsensitiveIndex bis zum Ende der Zeichenfolge. |
| FullName.Length- | Bei Zeichenfolgenvergleich wird zwischen Groß- und Kleinschreibung unterschieden. |
Rückgabewert
RtlFindUnicodePrefix gibt einen Zeiger auf das längste richtige Präfix zurück, das für die angegebene Zeichenfolge bei FullName-gefunden wurde. Wenn kein übereinstimmende Präfix gefunden wird, gibt RtlFindUnicodePrefixNULL-zurück.
Bemerkungen
Jeder Präfixeintrag in der Tabelle ist ein Pfadname relativ zum Stammverzeichnis eines Dateisystemvolumes. Um wohlgeformt zu sein, muss das Präfix mit einem einzelnen umgekehrten Schrägstrich () beginnen.
Wenn ein passendes Präfix gefunden wird, RtlFindUnicodePrefix die Wiedergabestruktur der Präfixtabelle neu ausbalanciert.
Dateisysteme müssen RtlInitializeUnicodePrefix- aufrufen, um die Präfixtabelle zu initialisieren, bevor Sie andere Rtl verwenden. UnicodePrefix Routinen. Die initialisierte Präfixtabellenstruktur sollte als undurchsichtig betrachtet werden.
Anrufer der Rtl.. UnicodePrefix- Routinen sind für die Synchronisierung des Zugriffs auf die Präfixtabelle verantwortlich. Ein schneller Mutex ist der effizienteste Synchronisierungsmechanismus, der für diesen Zweck verwendet werden kann.
Informationen zu anderen Zeichenfolgenbehandlungsroutinen finden Sie unter Run-Time Library (RTL)-Routinen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP |
| mindestens unterstützte Server- | Windows Server 2003 |
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | PASSIVE_LEVEL |