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
Zeiger auf die Präfixtabelle. Die Tabelle muss durch Aufrufen von RtlInitializeUnicodePrefix initialisiert worden sein.
[in] Prefix
Zeiger auf die Namenszeichenfolge, die mit dem Element unter PrefixTableEntry eingefügt werden soll.
[out] PrefixTableEntry
Zeiger auf den vom Aufrufer zugewiesenen Speicher, der mindestens sizeof(UNICODE_PREFIX_TABLE_ENTRY) sein muss, damit das Element für das neue Präfix eingefügt werden soll. RtlInsertUnicodePrefix initialisiert dieses Element, 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 wird FALSE zurückgegeben, wenn bereits ein doppeltes Element in der Präfixtabelle vorhanden ist.
Hinweise
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 glich RtlInsertUnicodePrefix die Wiedergabestruktur der Präfixtabelle aus.
Dateisysteme müssen RtlInitializeUnicodePrefix aufrufen, um die Präfixtabelle zu initialisieren, bevor eine andere Rtl.-Datei verwendet wird. UnicodePrefix-Routinen darauf. Die initialisierte Präfixtabellenstruktur sollte als undurchsichtig angesehen 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 Zeichenfolgenverarbeitungsroutinen finden Sie unter Laufzeitbibliotheksroutinen (RTL).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Zielplattform | Universell |
| Header | ntifs.h (include Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |