RtlInsertUnicodePrefix-Funktion (ntifs.h)

  • Artikel

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

Weitere Informationen

RtlFindUnicodePrefix

RtlInitializeUnicodePrefix

RtlNextUnicodePrefix

RtlRemoveUnicodePrefix

UNICODE_STRING