RtlNextUnicodePrefix-Funktion (ntifs.h)
Die RtlNextUnicodePrefix Routine wird verwendet, um die Elemente in einer Unicode-Präfixtabelle aufzählen zu können.
Syntax
NTSYSAPI PUNICODE_PREFIX_TABLE_ENTRY RtlNextUnicodePrefix(
[in] PUNICODE_PREFIX_TABLE PrefixTable,
[in] BOOLEAN Restart
);
Parameter
[in] PrefixTable
Zeigen Sie auf die Präfixtabelle. Die Tabelle muss durch Aufrufen von RtlInitializeUnicodePrefixinitialisiert worden sein.
[in] Restart
Wird auf TRUE- festgelegt, wenn die Aufzählung beim ersten Element in der Tabelle gestartet werden soll. Wird auf FALSE- festgelegt, wenn die Enumeration aus einem vorherigen Aufruf fortgesetzt wird.
Wenn Sie alle Elemente in der Tabelle aufzählen möchten, 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.
Bemerkungen
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 |