RtlInsertUnicodePrefix-Funktion (ntifs.h)
Die RtlInsertUnicodePrefix Routine fügt ein neues Element in eine Unicode-Präfixtabelle ein.
Syntax
NTSYSAPI BOOLEAN RtlInsertUnicodePrefix(
[in] PUNICODE_PREFIX_TABLE PrefixTable,
[in] __drv_aliasesMem PUNICODE_STRING Prefix,
[out] PUNICODE_PREFIX_TABLE_ENTRY PrefixTableEntry
);
Parameter
[in] PrefixTable
Zeigen Sie auf die Präfixtabelle. Die Tabelle muss durch Aufrufen von RtlInitializeUnicodePrefixinitialisiert worden sein.
[in] Prefix
Zeigen Sie auf die Namenszeichenfolge, die mit dem Element bei PrefixTableEntryeingefügt werden soll.
[out] PrefixTableEntry
Zeiger auf vom Aufrufer zugewiesenen Speicher, der mindestens Größe von(UNICODE_PREFIX_TABLE_ENTRY) sein muss, damit das Element für das neue Präfix eingefügt werden soll. RtlInsertUnicodePrefix dieses Element initialisiert, das vom Aufrufer als undurchsichtig angesehen werden sollte.
Rückgabewert
RtlInsertUnicodePrefix gibt TRUE zurück, wenn das neue Element in die Präfixtabelle eingefügt wurde, oder es gibt FALSE zurück, wenn bereits ein doppeltes Element in der Präfixtabelle vorhanden ist.
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.
Nach dem Einfügen des neuen Elements RtlInsertUnicodePrefix 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- | < DISPATCH_LEVEL |