RtlNextUnicodePrefix-Funktion (ntifs.h)

Die RtlNextUnicodePrefix-Routine wird verwendet, um die Elemente in einer Unicode-Präfixtabelle aufzulisten.

Syntax

NTSYSAPI PUNICODE_PREFIX_TABLE_ENTRY RtlNextUnicodePrefix(
  [in] PUNICODE_PREFIX_TABLE PrefixTable,
  [in] BOOLEAN               Restart
);

Parameter

[in] PrefixTable

Zeiger auf die Präfixtabelle. Die Tabelle muss durch Aufrufen von RtlInitializeUnicodePrefix initialisiert worden sein.

[in] Restart

Legen Sie auf TRUE fest, wenn die Enumeration beim ersten Element in der Tabelle beginnen soll. Legen Sie auf FALSE fest, wenn die Enumeration aus einem vorherigen Aufruf fortgesetzt wird.

Um alle Elemente in der Tabelle aufzulisten, verwenden Sie RtlNextUnicodePrefix wie folgt:

for (p = RtlNextUnicodePrefix ( Table, TRUE );
     p != NULL;
     p = RtlNextUnicodePrefix ( Table, FALSE )) {
        // Process the element pointed to by p
}

Rückgabewert

RtlNextUnicodePrefix gibt einen Zeiger auf das nächste Element zurück, sofern vorhanden. Wenn keine weiteren Elemente in der Tabelle vorhanden sind, gibt RtlNextUnicodePrefixNULL zurück.

Hinweise

Dateisysteme müssen RtlInitializeUnicodePrefix aufrufen, um die Präfixtabelle zu initialisieren, bevor sie andere Rtl. verwenden. UnicodePrefix-Routinen darauf. 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 für diesen Zweck.

Informationen zu anderen Zeichenfolgenbehandlungsroutinen finden Sie unter Laufzeitbibliotheksroutinen (RTL).

Anforderungen

Weitere Informationen

RtlFindUnicodePrefix

RtlInitializeUnicodePrefix

RtlInsertUnicodePrefix

RtlRemoveUnicodePrefix