Функция RtlNextUnicodePrefix (ntifs.h)
Подпрограмма RtlNextUnicodePrefix используется для перечисления элементов в таблице префикса Юникода.
Синтаксис
NTSYSAPI PUNICODE_PREFIX_TABLE_ENTRY RtlNextUnicodePrefix(
[in] PUNICODE_PREFIX_TABLE PrefixTable,
[in] BOOLEAN Restart
);
Параметры
[in] PrefixTable
Указатель на таблицу префикса. Таблица должна быть инициализирована путем вызова RtlInitializeUnicodePrefix.
[in] Restart
Задайте значение TRUE, если перечисление начинается с первого элемента в таблице. Установите значение FALSE при возобновлении перечисления из предыдущего вызова.
Чтобы перечислить все элементы таблицы, используйте RtlNextUnicodePrefix следующим образом:
for (p = RtlNextUnicodePrefix ( Table, TRUE );
p != NULL;
p = RtlNextUnicodePrefix ( Table, FALSE )) {
// Process the element pointed to by p
}
Возвращаемое значение
RtlNextUnicodePrefix возвращает указатель на следующий элемент, если он существует. Если в таблице больше элементов нет, RtlNextUnicodePrefix возвращает NULL.
Замечания
Файловые системы должны вызывать RtlInitializeUnicodePrefix, чтобы инициализировать таблицу префикса перед использованием любой другой Rtl.. Подпрограммы ЮникодаPrefix на нем. Инициализированная структура таблицы префикса должна считаться непрозрачной.
Вызывающие Rtl.. Подпрограммы ЮникодаPrefix отвечают за синхронизацию доступа к таблице префикса. Быстрый мьютекс — это наиболее эффективный механизм синхронизации, используемый для этой цели.
Дополнительные сведения о других подпрограммах обработки строк см. в Run-Time подпрограммах библиотеки (RTL).
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows XP |
| минимальный поддерживаемый сервер | Windows Server 2003 |
| целевая платформа | Всеобщий |
| заголовка | ntifs.h (include Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |